(IN) Specifies the NetWare server connection handle.
objID
(IN) Specifies the object ID of the user or group for which the
trustee information is to be found.
volNum
(IN) Specifies the volume number of the volume being searched.
iterHandle
(IN) Points to the sequence number.
accessRights
(OUT) Points to the trustee's access mask.
dirPath
(OUT) Points to the current trustee's directory path name (should be at
least 270 bytes).
Return values
0x0000
SUCCESSFUL
0x8801
INVALID_CONNECTION
0x8993
NO_READ_RRIVILEGES
0x8996
SERVER_OUT_OF_MEMORY
0x89A1
DIRECTORY_IO_ERROR
0x89F0
WILD_CARD_NOT_ALLOWED
0x89F1
INVALID_BINDERY_SECURITY
0x89F2
NO_OBJECT_READ_PRIVILEGE
Notices
NWScanObjectTrusteePaths iteratively determines all of a bindery
object's trustee directory paths and corresponding access masks.
iterHandle is an index to the next directory path and should
initially be set to -1. iterHandle is automatically incremented
to point to the next directory path. When all valid directory paths have
been returned, dirPath is set to NULL.
Only SUPERVISOR, the object, or a bindery object with
SUPERVISOR security equivalence can scan an object's trustee
directory paths.
NetWare rights changed between versions 2.x and 3.x. Since
NWScanObjectTrusteePaths was originally written for the 2.x
platform, it does not handle 3.x and 4.x rights perfectly. For example, on
the 3.x and 4.x platforms, it does not return the 2.x ``Supervisory''
right. To retrieve the correct trustee rights on the 3.x and 4.x
platforms, first call NWScanObjectTrusteePaths to obtain a path,
and then call NWScanForTrustees to return the object's right
to the path.
The trustee access rights mask follows and is defined in nwdirect.h
and nwnamspc.h (TA_OPEN is obsolete in 3.x):