NWIntScanDirEntryInfo

Syntax

   #include <nwdentry.h> 
   or 
   #include <nwcalls.h> 
    
   N_EXTERN_LIBRARY(NWCCODE) NWIntScanDirEntryInfo ( 
      NWCONN_HANDLE        conn,  
      NWDIR_HANDLE         dirHandle,  
      nuint16              attrs,  
      pnuint32             iterHandle,  
      const nuint8 N_FAR  *searchPattern,  
      NWENTRY_INFO N_FAR  *entryInfo,  
      nuint16              augmentFlag);
   

Delphi Syntax

   uses calwin32 
    
   Function NWIntScanDirEntryInfo 
     (conn :  NWCONN_HANDLE; 
      dirHandle : NWDIR_HANDLE; 
      attrs : nuint16; 
      iterHandle : pnuint32; 
      searchPattern : pnuint8; 
      Var entryInfo : NWENTRY_INFO; 
      augmentFlag : nuint16 
   ) : NWCCODE ;
   

Parameters

conn

(IN) Specifies the NetWare server connection handle.

dirHandle

(IN) Specifies the NetWare DOS directory handle indexing the directory to scan (not optional, cannot be 0).

attrs

(IN) Specifies the attributes to be used for the scan.

iterHandle

(IN/OUT) Points to an nuint32 buffer to receive the search sequence from the server.

searchPattern

(IN) Points to the name of the entry for which to scan (wildcards are allowed).

entryInfo

(OUT) Points to the NWENTRY_INFO structure (zeroed out initially).

augmentFlag

(IN) Specifies if wildcards are augmented:

• 0 = wildcards are not augmented
• nonzero = wildcards are augmented

Return Values

These are common return values; see Return Values (Return Values for C) for more information.

Remarks

NWIntScanDirEntryInfo can only be called with non-augmented wildcards if the augmentFlag parameter is set to 0. For example, *.* will match anything with a period, while * will match any string.

NWIntScanDirEntryInfo will support augmented wildcard characters if the augmentFlag parameter is set to 1 or if the high-order bits have been manually set. For example, * will now match zero or more characters up to a period or an end-of-string.

On the first call, the iterHandle parameter should point to 0xFFFFFFFF. After that, the server manages the information. All scanning is complete when the server returns 0x89FF.

The searchPattern parameter cannot point to any path elements and the dirHandle parameter must index the complete path.

NWIntScanDirEntryInfo can also be used to scan for information about other directories, including the root directory. In this mode, the dirHandle parameter needs to index the root or a directory, and the searchPattern parameter needs to point to NULL.

NWIntScanDirEntryInfo works with the DOS name space only. Path and file names must be upper cased. To scan using alternate name spaces, convert the path to a DOS name space by calling either the NWGetNSPath or NWScanNSEntryInfo function. You can also scan the Macintosh name space by calling the NWAFPScanFileInformation function.

The attrs parameter can have the following values:

The NWENTRY_INFO structure should be initialized to 0 before NWIntScanDirEntryInfo is called for the first time.

NCP Calls

• 0x2222 22 01 Get Directory Path
• 0x2222 22 30 Scan A Directory
• 0x2222 22 31 Get Directory Entry

See Also

NWAFPScanFileInformation (Single and Intra-File Management), NWGetNSInfo, NWIntScanExtendedInfo, NWScanNSEntryInfo