NWIntScanDirectoryInformation2

Returns directory information for a directory specified by the connection handle, directory handle, and directory path

NetWare Server:3.11, 3.12, 3.2, 4.x, 5.x, 6.x
Platform:Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:File System

Syntax

   #include <nwdirect.h> 
   or 
   #include <nwcalls.h> 
    
   N_EXTERN_LIBRARY(NWCCODE) NWIntScanDirectoryInformation2 ( 
      NWCONN_HANDLE        conn,  
      NWDIR_HANDLE         dirHandle,  
      const nstr8 N_FAR   *srchPath,  
      pnuint8              sequence,  
      pnstr8               dirName,  
      pnuint32             dirDateTime,  
      pnuint32             ownerID,  
      pnuint8              rightsMask,  
      nuint16              augmentFlag);

Delphi Syntax

   uses calwin32 
    
   Function NWIntScanDirectoryInformation2 
     (conn : NWCONN_HANDLE; 
      dirHandle : NWDIR_HANDLE; 
      searchPath : pnstr8; 
      sequence : pnuint8; 
      dirName : pnstr8; 
      dirDateTime : pnuint32; 
      ownerID : pnuint32; 
      rightsMask : pnuint8; 
      augmentFlag : nuint16 
   ) : NWCCODE;

Parameters

conn

(IN) Specifies the NetWare server connection handle.

dirHandle

(IN) Specifies the NetWare directory handle for the directory being scanned.

srchPath

(IN) Points to an absolute directory path with a maximum length of 255 (or a path relative to the directory handle) and a search pattern (optional).

sequence

(IN/OUT) Points to a 9-byte sequence number to be used for subsequent calls (the first 4 bytes should be 0xFF initially).

dirName

(OUT) Points to the directory name found (256 bytes, optional).

dirDateTime

(OUT) Points to the creation date and time of the directory (4 bytes, optional) in the DOS date and time format.

ownerID

(OUT) Points to the object ID of the owner for the directory (optional).

rightsMask

(OUT) Points to the maximum rights mask for the directory found (optional).

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.

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x8998

VOLUME_DOES_NOT_EXIST

0x899B

BAD_DIRECTORY_HANDLE

0x899C

INVALID_PATH

0x89FF

NO_FILES_FOUND_ERROR

Remarks

All parameter fields must be filled. However, NULL may be substituted in parameters where no information is desired.

The dirHandle parameter can be zero if the srchPath parameter points to the complete path, including the volume name.

The string accessed by the srchPath parameter can include wildcard characters. If wildcards are used, only the directory information for the first matching directory is returned.

The rightsMask parameter can have the following values:

   0x00 = TA_NONE 
   0x01 = TA_READ 
   0x02 = TA_WRITE 
   0x04 = TA_OPEN 
   0x08 = TA_CREATE 
   0x10 = TA_DELETE 
   0x20 = TA_OWNERSHIP 
   0x40 = TA_SEARCH 
   0x80 = TA_MODIFY 
   0xFB = TA_ALL

NOTE:TA_OPEN is obsolete in NetWare 3.x and above.

NCP Calls

See Also

NWParseNetWarePath