en:docs:fapi:dosfindclose

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		Previous revision
en:docs:fapi:dosfindclose [2018/08/30 13:37] – created prokusheven:docs:fapi:dosfindclose [2021/09/18 04:33] (current) – prokushev
Line 1: Line 1:
 +{{page>en:templates:fapiint}}
  
-This call closes the association between a directory handle and a [[DosFindFirst (FAPI)|DosFindFirst]] or [[DosFindNext (FAPI)|DosFindNext]] directory search function.+====== DosFindClose ======
  
-==Syntax== +This call closes the association between a directory handle and a [[DosFindFirst]] or [[DosFindNext]] directory search function.
- DosFindClose (DirHandle)+
  
-==Parameters== +===== Syntax ===== 
-;DirHandle ([[HDIR]]) - input : bHandle previously associated with a DosFindFirst by the system, or used with a DosFindNext directory search function.+ 
 +<code c> 
 +DosFindClose (DirHandle) 
 +</code> 
 + 
 +===== 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== 
- rc (USHORT) - return 
 Return code descriptions are: Return code descriptions are:
-* 0  NO_ERROR 
-* 6  ERROR_INVALID_HANDLE Remarks 
  
-==Remarks== +  * 0  NO_ERROR 
-When ''DosFindClose'' is issued, a subsequent ''DosFindNext'' for the closed DirHandle fails unless an intervening DosFindFirst has been issued specifying DirHandle.+  * 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 ====
  
-==Bindings== +<code c>
-===C Binding=== +
-<PRE>+
 #define INCL_DOSFILEMGR #define INCL_DOSFILEMGR
  
Line 26: Line 39:
 HDIR    DirHandle;     /* Directory search handle */ HDIR    DirHandle;     /* Directory search handle */
 USHORT  rc;            /* return code */ USHORT  rc;            /* return code */
-</PRE>+</code>
  
-===MASM Binding=== +==== MASM Binding ==== 
-<PRE>+ 
 +<code asn>
 EXTRN  DosFindClose:FAR EXTRN  DosFindClose:FAR
 INCL_DOSFILEMGR     EQU 1 INCL_DOSFILEMGR     EQU 1
Line 35: Line 49:
 PUSH   WORD    DirHandle     ;Directory search handle PUSH   WORD    DirHandle     ;Directory search handle
 CALL   DosFindClose CALL   DosFindClose
 +
 +</code>
  
 Returns WORD Returns WORD
-</PRE> 
  
-==Example==+==== Example ==== 
 This example searches for a file, then closes the search. This example searches for a file, then closes the search.
-<PRE>+<code c>
 #define INCL_DOSFILEMGR #define INCL_DOSFILEMGR
 #define SEARCH_PATTERN "*.*" #define SEARCH_PATTERN "*.*"
Line 60: Line 76:
                      RESERVED);             /* Reserved (must be zero) */                      RESERVED);             /* Reserved (must be zero) */
    rc = DosFindClose(FindHandle);           /* Directory search handle */    rc = DosFindClose(FindHandle);           /* Directory search handle */
-</PRE> +</code>
- +
- +
  
-====== Note ======+===== Note =====
  
 Text based on [[http://www.edm2.com/index.php/DosFindClose_(OS/2_1.x)]] Text based on [[http://www.edm2.com/index.php/DosFindClose_(OS/2_1.x)]]
  
 {{page>en:templates:fapi}} {{page>en:templates:fapi}}