NWIntScanExtendedInfo

Syntax

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

Delphi Syntax

   uses calwin32 
    
   Function NWIntScanExtendedInfo 
     (conn : NWCONN_HANDLE; 
      dirHandle : NWDIR_HANDLE; 
      attrs : nuint8; 
      iterHandle : pnuint32; 
      const searchPattern : pnstr8; 
      Var entryInfo : NW_EXT_FILE_INFO; 
      augmentFlag : nuint16 
   ) : NWCCODE ;
   

Parameters

conn

(IN) Specifies the NetWare server connection handle.

dirHandle

(IN) Specifies the NetWare directory handle for the directory to be scanned.

attrs

(IN) Specifies the search attributes.

iterHandle

(IN/OUT) Points to the search sequence number (-1 initially).

searchPattern

(IN) Points to the pattern for which to search (no wildcards are allowed).

entryInfo

(OUT) Points to the NW_EXT_FILE_INFO structure containing the extended file information.

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

NWIntScanExtendedInfo works only on files, not on directories.

All scanning is complete when the server returns 0x89FF.

NWIntScanExtendedInfo is synonymous with the NWIntScanDirEntryInfo function and uses an extension of the information structure.

The iterHandle parameter should point to 0xFFFFFFFF for the first call.

The attrs parameter is used to include system and/or hidden files. If only the system bit is set in the attrs parameter, all files are affected except hidden files. If only the hidden bit is set, all files are affected except system files. When neither bit is set (0x00), only files designated either hidden or system are affected.

The attrs parameter can have the following values:

The extended file information contains the information returned by the NWIntScanDirEntryInfo function plus the sizes of the data and resource forks. NWIntScanExtendedInfo also returns the physical size of a file.

NCP Calls

• 0x2222 22 40 Scan Directory Disk Space

See Also

NWIntScanDirEntryInfo, NWScanNSEntryInfo