NWScanObjectTrusteePaths(3nw)


NWScanObjectTrusteePaths -- returns directory paths to which object has trustee rights

Synopsis

   #include <nwbindry.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWScanObjectTrusteePaths (NWCONN_HANDLE conn, nuint32 objID, nuint16 volNum, pnuint16 iterHandle, pnuint8 accessRights, pnstr8 dirPath);

Description

The parameters are as follows:

conn
(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):

0x00
TA_NONE

0x01
TA_READ

0x02
TA_WRITE

0x04
TA_OPEN

0x08
TA_CREATE

0x10
TA_DELETE

0x20
TA_OWNERSHIP

0x40
TA_SEARCH

0x80
TA_MODIFY

0xFB
TA_ALL

Services

Bindery

NCP calls

0x2222 23 71 Scan Bindery Object Trustee Paths

 
 0x2222   23   71   Scan Bindery 
                    Object Trustee 
                    Paths 

References

NWScanForTrustees(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.