Syntax

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

Parameters

conn

(IN) Specifies the NetWare server connection handle.

objID

(IN) Specifies the ID of the object of the user.

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. The characters in the string must be UTF-8.

buNameSpace

(IN) Specifies the name space of the specified path. See Name Space Flag Values in Multiple and Inter-File Services.

rightsMask

(OUT) Points to the rights mask. See Inherited Rights Mask Values. If the rightsMask parameter is zero, the client has no rights in the target directory.

Return Values

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

Remarks

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

The current trustee rights of the client are obtained by performing a logical OR between a trustee access mask of the client and the trustee access mask of any object to which the process is security equivalent. The current trustee rights of the client can 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.

NCP Calls

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

See Also

NWGetEffectiveRightsExt (Multiple and Inter-File Management)