(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 (or a path relative to the
directory handle) and a search pattern.
iterHandle
(IN/OUT) Points to the sequence number to be used for subsequent calls.
Should initially be set to 0.
dirName
(OUT) Points to the directory name found (optional, up to 256 bytes).
dirDateTime
(OUT) Points to the directory's creation date and time (optional).
ownerID
(OUT) Points to the bindery object ID of the directory's owner (optional).
trusteeList
(OUT) Points to an array of 20 TRUSTEE_INFO structures.
Return values
0x0000
SUCCESSFUL
0x8801
INVALID_CONNECTION
0x898C
N0_MODIFY_PRIVILEGES
0x8996
SERVER_OUT_OF_MEMORY
0x8998
VOLUME_DOES_NOT_EXIST
0x899B
BAD_DIRECTORY_HANDLE
0x899C
NO_MORE_TRUSTEES
Notices
srchPath scans include wildcard characters. If srchPath
points to the complete path, including the volume name, dirHandle
can be zero.
Directories can have any number of Bindery objects as trustees. These
directory trustees are stored and retrieved in groups on the server. To
obtain a complete list, use iterHandle, which should point to a
zero value for the initial call.
NWScanDirectoryForTrustees2 increments the value referenced by
iterHandle to the next appropriate value. For subsequent calls,
pass in the new value of iterHandle.
Trustees are returned in groups of 20 TRUSTEE_INFO structures.
Due to subtle differences in the operation of 2.x and 3.x servers,
trustees may remain after an iteration, even though not all 20 positions
are filled. If a position is not filled, ownerID points to a
value of 0L.
NWScanDirectoryForTrustees2 should be called until it returns
0x899C (NO_MORE_TRUSTEES). Because 0x899C also means
INVALID_PATH, ensure the dirHandle/pbstrSrchPath
combination is correct.
NULL can be substituted for all optional items; however, all
parameter positions must be filled.