DBMCloseScan

Description
현재 open된 스캔을 종료한다.

Syntax
DBMErr DBMCloseScan(ScanId scanId);

Parameters
scanId 현재 open된 스캔 ID

Returns
value설명
DBM_OK성공적으로 수행된 경우
DBM_INVALID_SCAN_ID 주어진 스캔 id를 갖는 스캔이 존재하지 않는 경우
DBM_DB_NOT_INITED데이타베이스가 초기화되어 있지 않은 경우

Comments
스캔을 open한 경우, 검색이 끝난 후에 DBMCloseScan을 반드시 호출해야 한다.
DBMCloseScan을 호출하지 않을 경우, open된 스캔 관리자의 메모리 공간이 free되지 않는다. 또한 현재 동시에 open된 스캔의 개수를 NUM_SCANS로 제한하고 있으므로, open된 스캔을 close해주지 않으면 언젠가는 더 이상 스캔을 open할 수 없게 되어 검색이 불가능하게 된다.

See Also
DBMOpenSeqScanTable, DBMOpenSeqScanCategory, DBMOpenIndexScanTable, DBMGetNextRecordId, DBMGetPrevRecordId, DBMGetNextRecordIdWithJump

Example
  /* Get scanId and recId. See the example of DBMOpenSeqScanTable */
  ...
  ret = DBMOpenSeqScanTable( tableId, indexFlag, offset, recOrder, &scanId);
  if( ret < DBM_OK ) // error handling
  ...
  ret = DBMCloseScan(scanId);
  ...