AIT_FindCloseFile

Description

Closes a file search handle returned by the AIT_FindFirstFile function.

Format

bool AIT_FindCloseFile  (
 integer nSearchHandle     // File search handle
);

Parameters

nSearchHandle (input)

Specify a file search handle returned by the AIT_FindFirstFile function.

Return values

The return value is true if the function was executed normally, and false if not. If the function has returned false, you can use AIT_GetLastError to acquire an extended error code. The following gives the error codes that AIT_GetLastError might return:

Extended error numberError code
6ERROR_INVALID_HANDLE
8ERROR_NOT_ENOUGH_MEMORY
14ERROR_OUTOFMEMORY
112ERROR_DISK_FULL

Note

After having called the AIT_FindClose function, you cannot use the handle set in the nSearchHandle parameter to subsequently call the AIT_FindNextFile or AIT_FindCloseFile function.