as_DBMCloseScan

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

Syntax
DBMErr as_DBMCloseScan(ScanId scanId);

Parameters
scanId 현재 open된 스캔 ID

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

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

See Also
as_DBMOpenSeqScanTable, as_DBMOpenSeqScanCategory, as_DBMOpenIndexScanTable, as_DBMGetNextRecordId, as_DBMGetPrevRecordId, as_DBMGetNextRecordIdWithJump

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