Scans a directory for trustees using the specified path and directory handle under a specified name space
#include <nwnamspc.h>
or
#include <nwcalls.h>
NWCCODE N_API NWScanNSDirectoryForTrustees (
NWCONN_HANDLE conn,
nuint8 namSpc,
nuint8 dirHandle,
const nstr8 N_FAR *srchPath,
pnuint32 iterHandle,
pnstr8 dirName,
pnuint32 dirDateTime,
pnuint32 ownerID,
TRUSTEE_INFO N_FAR *trusteeList);
(IN) Specifies the NetWare server connection handle.
(IN) Specifies the name space of the dirHandle/srchPath combination (see Section 20.5, Name Space Flag Values).
(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.
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.
NWScanNSDirectoryForTrustees 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 has to a value of 0L.
NWScanNSDirectoryForTrustees should be called until iterHandle is -1 or 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.