Syntax

   #include <nwbindry.h> 
   or 
   #include <nwcalls.h> 
    
   NWCCODE N_API NWGetObjectEffectiveRights ( 
      NWCONN_HANDLE       conn,  
      nuint32             objID,  
      NWDIR_HANDLE        dirHandle,  
      const nstr8 N_FAR  *path,  
      pnuint16            rightsMask);
   

   uses calwin32 
    
   Function NWGetObjectEffectiveRights 
     (conn : NWCONN_HANDLE; 
      objID : nuint32; 
      dirHandle : NWDIR_HANDLE; 
      const path : pnstr8; 
      rightsMask : pnuint16 
   ) : NWCCODE; stdcall;
   

Parameters

conn

(IN) Specifies the NetWare server connection handle.

objID

(IN) Specifies the ID of the object in the specified directory or file.

dirHandle

(IN) Specifies the NetWare directory handle associated with the directory path for which the effective rights are desired.

path

(IN) Points to the absolute path (or a path relative to the dirhandle parameter) of the directory or file whose effective rights mask is being reported.

rightsMask

(OUT) Points to the rights mask.

Return Values

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

Remarks

To determine the effective rights of the requesting workstation, NWGetObjectEffectiveRights performs a logical AND between the maximum rights mask of the directory and the current trustee rights of the workstation.

The current trustee rights of the workstation are obtained by performing a logical OR between a trustee access mask of the workstation and the trustee access mask of any object to which the process is security equivalent. The current trustee rights of the workstation may be explicitly listed in the directory or inherited from the parent directory. The maximum rights masks of parent directories do not affect inherited trustee rights.

The rightsMask parameter returned to the client indicates which of the eight possible directory rights the client has in the targeted directory. If the rightsMask parameter is zero, the client has no rights in the target directory.

See Section 4.2, Maximum Rights Mask Values.

NCP Calls

• 0x2222 22 50 Get Object Effective Rights For Directory Entry

See Also

NWGetEffectiveRights (Multiple and Inter-File Management)