Syntax

   #include <nwbindry.h> 
   or 
   #include <nwcalls.h> 
    
   NWCCODE N_API  NWScanObjectTrusteePaths  ( 
      NWCONN_HANDLE   conn,  
      nuint32         objID,  
      nuint16         volNum,  
      pnuint16        iterHandle,  
      pnuint8         accessRights,  
      pnstr8          dirPath);
   

   uses calwin32 
    
   Function NWScanObjectTrusteePaths 
     (conn : NWCONN_HANDLE; 
      objID : nuint32; 
      volNum : nuint16; 
      iterHandle : pnuint16; 
      accessRights : pnuint8; 
      dirPath : pnstr8 
   ) : NWCCODE; stdcall;
   

Parameters

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/OUT) Points to the sequence number (set to -1 initially).

accessRights

(OUT) Points to the access mask of the trustee.

dirPath

(OUT) Points to the directory path name in the DOS name space. This buffer should be at least 270 bytes.

Return Values

These are common return values. See Return Values (Return Values for C).

Remarks

NWScanObjectTrusteePaths iteratively determines all of the directory paths of the bindery object trustee and corresponding access masks.

Upon return, the iterHandle parameter is automatically incremented to point to the next directory path. When all valid directory paths have been returned, SUCCESS is returned and the first character of the dirPath parameter is set to zero.

To use the DOS path returned by the dirPath parameter in subsequent calls, you might have to convert the DOS path to the default name space compatible path.

Only SUPERVISOR, the object, or a bindery object with SUPERVISOR security equivalence can scan the directory paths of an object trustee.

NWScanObjectTrusteePaths was originally written for the 2.x platform and does not handle 3.x, 4.x, 5.x, and 6.x rights perfectly. For example, NWScanObjectTrusteePaths does not return the 2.x "Supervisory" right. To retrieve the correct trustee rights on the 3.x, 4.x, 5.x, and 6.x platforms, call NWScanObjectTrusteePaths to obtain a path. Then call the NWIntScanForTrustees function to return the rights of the object to the path.

See Section 4.2, Maximum Rights Mask Values.

NCP Calls

• 0x2222 23 71 Scan Bindery Object Trustee Paths

See Also

NWIntScanForTrustees (Multiple and Inter-File Management)