Interrupt 21h Function 71A1h

Closes the file search identified by the search handle.

mov ax, 71A1h   ; Find Close
mov bx, Handle  ; see below
int 21h

jc  error

Parameters

Handle

Search handle. It must have been previously returned from Find First File (Interrupt 21h Function 714Eh).

Return Value

Clears the carry flag if successful. Otherwise, the function sets the carry flag and sets the AX register to an error value.

Remarks

Unlike MS-DOS Find First File (Interrupt 21h Function 4Eh), the long filename version of Find First File (Interrupt 21h Function 714Eh) allocates internal storage for the search operations and returns a handle that identifies the storage. This handle is used with Find Next File. To make sure this internal storage is freed, you must call Find Close to end the search.