Scans a directory for trustees using the specified path and directory handle
#include <nwdirect.h>
or
#include <nwcalls.h>
N_EXTERN_LIBRARY(NWCCODE) NWScanDirectoryForTrustees2 (
NWCONN_HANDLE conn,
NWDIR_HANDLE dirHandle,
const nstr8 N_FAR *srchPath,
pnuint32 iterHandle,
pnstr8 dirName,
pnuint32 dirDateTime,
pnuint32 ownerID,
TRUSTEE_INFO N_FAR *trusteeList);
uses calwin32
Function NWScanDirectoryForTrustees2
(conn : NWCONN_HANDLE;
dirHandle : NWDIR_HANDLE;
searchPath : pnstr8;
iterHandle : pnuint32;
dirName : pnstr8;
dirDateTime : pnuint32;
ownerID : pnuint32;
Var trusteeList : TRUSTEE_INFO
) : NWCCODE;
(IN) Specifies the NetWare server connection handle.
(IN) Specifies the NetWare directory handle for the directory being scanned (0 if the srchPath parameter points to the complete path, including the volume name).
(IN) Points to an absolute directory path (or a path relative to the directory handle) and a search pattern.
(IN/OUT) Points to the sequence number to be used for subsequent calls (0 initially).
(OUT) Points to the directory name found (optional, up to 256 bytes).
(OUT) Points to the creation date and time of the directory (optional).
(OUT) Points to the object ID of the directory owner (optional).
(OUT) Points to an array of 20 TRUSTEE_INFO structures.
These are common return values; see Return Values (Return Values for C) for more information.
The srchPath parameter can include wildcard characters.
Directories can have any number of objects as trustees. The directory trustees are stored and retrieved in groups on the server. To obtain a complete list, use the iterHandle parameter.
NWScanDirectoryForTrustees2 increments the value referenced by the iterHandle parameter to the next appropriate value. For subsequent calls, pass in the new value of the iterHandle parameter.
Trustees are returned in groups of 20 TRUSTEE_INFO structures. Due to subtle differences in operation, trustees may remain after an iteration, even though not all 20 positions are filled. If a position is not filled, the objectID field of TRUSTEE_INFO 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 parameter combination is correct.
NULL can be substituted for all optional items. However, all parameter positions must be filled.