Closes a file search handle returned by the AIT_FindFirstFile function.

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

nSearchHandle (input)

Specify a file search handle returned by the AIT_FindFirstFile function.

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 number	Error code
6	ERROR_INVALID_HANDLE
8	ERROR_NOT_ENOUGH_MEMORY
14	ERROR_OUTOFMEMORY
112	ERROR_DISK_FULL

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.