#include <nwdentry.h> or #include <nwcalls.h>NWCCODE N_API NWScanForTrustees (NWCONN_HANDLE conn, NWDIR_HANDLE dirHandle, pnstr8 path, pnuint32 iterHandle, pnuint16 numOfEntries, NWET_INFO NWFAR
entryTrusteeInfo);
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 postion is not filled, objectID is set to 0L. Check objectID before printing each objectRights.
dirHandle can be zero if path points to the complete path, including the volume name. path can point to wildcard characters. However, only the first matching directory is scanned (behavior typical of 2.x servers).
Directories can have any number of bindery objects as trustees. Trustees are returned in groups of 20 TRUSTEE_INFO structures. To obtain a complete list, set sequence to 0L for the initial call. NWScanForTrustees should then be called (for example in a while or do loop) until it returns 0x899C (NO_MORE_TRUSTEES). Because 0x899C also indicates INVALID_PATH, ensure the dirHandle/path combination is correct.
NWET_INFO receives trustee information; however, only
TRUSTEE_INFO is valid for servers 3.x and later. The first
three fields, entryName
, creationDate
, and
ownerID
are valid only for 2.x servers.
NWET_INFO receives trustee information; however, only
TRUSTEE_INFO is valid for servers 3.x and later. The first
three fields, entryName
, creationDateAndTime
, and
ownerID
are valid only for 2.x servers. sequenceNumber
should always be ignored.
NWScanForTrustees should be called until it returns 0x899C (NO_MORE_TRUSTEES). Because 0x899C also means INVALID_PATH, ensure the dirHandle/path combination is correct.
NULL can be substituted for items listed as optional.
0x2222 | 22 | 12 | Scan Directory For Trustees |
0x2222 | 22 | 38 | Scan File Or Directory For Extended Trustees |
0x2222 | 23 | 17 | Get File Server Information |
0x2222 | 87 | 05 | Scan File Or Subdirectory For Trustees |