CBL_DIR_SCAN_END

Terminates a search operation.

Syntax:

CALL "CBL_DIR_SCAN_END" using  by reference   handle
                                  returning   search-status

Parameters:

handle: Usage pointer
search-status: See Library Routines - Key

On Entry:

handle: Set by CBL_DIR_SCAN_START. This field identifies the search operation that is to be terminated.

On Exit:

handle

Undefined

search-status

Return status:

0	Success
1	Unable to start search
2	Invalid search handle
3	Search finished
127	Other error

Comments:

You must call CBL_DIR_SCAN_END to release system resources. You might be unable to start additional searches if you fail to release resources at the end of a scan operation.