en:docs:fapi:dosfindclose

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

Syntax

DosFindClose (DirHandle)

Parameters

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

Return Code

rc (USHORT) - return Return code descriptions are: * 0 NO_ERROR * 6 ERROR_INVALID_HANDLE Remarks

Remarks

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

Bindings

C Binding

<PRE> #define INCL_DOSFILEMGR

USHORT rc = DosFindClose(DirHandle);

HDIR DirHandle; /* Directory search handle */ USHORT rc; /* return code */ </PRE>

MASM Binding

<PRE> EXTRN DosFindClose:FAR INCL_DOSFILEMGR EQU 1

PUSH WORD DirHandle ;Directory search handle CALL DosFindClose

Returns WORD </PRE>

Example

This example searches for a file, then closes the search. <PRE> #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 */

</PRE>

Note


en/docs/fapi/dosfindclose.txt · Last modified: 2018/08/30 13:37 by prokushev