NWIntScanDirectoryInformation2(3nw)


NWIntScanDirectoryInformation2 -- returns directory information

Synopsis

   #include <nwdirect.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWIntScanDirectoryInformation2 (NWCONN_HANDLE conn, NWDIR_HANDLE dirHandle, pnstr8 srchPath, pnuint8 sequence, pnstr8 dirName, pnuint32 dirDateTime, pnuint32 ownerID, pnuint8 rightsMask, nuint16 augmentFlag);

Description

The parameters are as follows:

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. Set the first 4 bytes to 0xFF for the first call.

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

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

ownerID
(OUT) Points to the object ID of the directory's owner (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

non-zero
all wildcards are augmented

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8998
VOLUME_DOES_NOT_EXIST

0x899B
BAD_DIRECTORY_HANDLE

0x899C
INVALID_PATH

0x89FF
NO_FILES_FOUND_ERROR

Notices

NWIntScanDirectoryInformation2 is replacing NWScanDirectoryInformation2.

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

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

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

dirName is invalid when getting volume information for NetWare 2.2 servers.

dirDateTime does not point to valid information on 2.x servers and does not point to valid information for the root directory (volume) on 2.2 servers. Point dirDateTime to zero (0) when getting volume information for 2.2 servers. For volumes, 2.x servers do not return a directory name, and dirDateTime always points to zero (0).

rightsMask points to the subdirectory's maximum rights mask. The bits in the maximum rights mask are defined as follows:

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 3.x and 4.x calls.

Services

File Systems

NCP calls

0x2222 22 01
Get Directory Path

0x2222 22 02
Scan Directory Information

0x2222 23 17
Get File Server Information

0x2222 87 02
Initialize Search

0x2222 87 03
Search For File Or Subdirectory

0x2222 87 06
Obtain File Or Subdirectory Information

30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.