DosFindClose

This call closes the association between a directory handle and a DosFindFirst or DosFindNext directory search function.

DosFindClose (DirHandle)

• DirHandle (HDIR) - input : bHandle previously associated with a DosFindFirst by the system, or used with a DosFindNext directory search function.

rc (USHORT) - return

Return code descriptions are:

• 0 NO_ERROR
• 6 ERROR_INVALID_HANDLE Remarks

When DosFindClose is issued, a subsequent DosFindNext for the closed DirHandle fails unless an intervening DosFindFirst has been issued specifying DirHandle.

#define INCL_DOSFILEMGR
 
USHORT  rc = DosFindClose(DirHandle);
 
HDIR    DirHandle;     /* Directory search handle */
USHORT  rc;            /* return code */

EXTRN  DosFindClose:FAR
INCL_DOSFILEMGR     EQU 1
 
PUSH   WORD    DirHandle     ;Directory search handle
CALL   DosFindClose

Returns WORD

This example searches for a file, then closes the search.

#define INCL_DOSFILEMGR
#define SEARCH_PATTERN "*.*"
#define FILE_ATTRIBUTE 0
#define RESERVED 0L
 
HDIR  FindHandle;
 
   FindHandle = 0x0001;
   FindCount = 1;
 
   rc = DosFindFirst(SEARCH_PATTERN,        /* File pattern */
                     &FindHandle,           /* Directory search handle */
                     FILE_ATTRIBUTE,        /* Search attribute */
                     &FindBuffer,           /* Result buffer */
                     sizeof(FindBuffer),    /* Result buffer length */
                     &FindCount,            /* # of entries to find */
                     RESERVED);             /* Reserved (must be zero) */
   rc = DosFindClose(FindHandle);           /* Directory search handle */

Text based on http://www.edm2.com/index.php/DosFindClose_(OS/2_1.x)