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.