Syntax

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

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.

dirPath1506

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

Return Values

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

Remarks

NWScanObjectTrusteePathsExt iteratively determines all of the directory paths of the 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.

NWScanObjectTrusteePathsExt does not handle 6.x rights perfectly. To retrieve the correct trustee rights on the 6.x platforms, call NWScanObjectTrusteePathsExt to obtain a path. Then call the NWIntScanForTrusteesExt function in Multiple and Inter-File Services to return the rights of the object to the path.

NCP Calls

• 0x2222 23 71 Scan Bindery Object Trustee Paths
• 0x2222 89 71 Enhanced Scan Volume Trustee Object Paths

See Also

NWIntScanForTrusteesExt (Multiple and Inter-File Management)