NWGetEffectiveRightsExt

Syntax

   #include <nwdentry.h> 
   or 
   #include <nwcalls.h> 
    
   N_EXTERN_LIBRARY(NWCCODE) NWGetEffectiveRightsExt ( 
      NWCONN_HANDLE       conn,  
      NWDIR_HANDLE        dirHandle,  
      const nstr8 N_FAR  *path,  
      pnuint16            effectiveRights);
   

Parameters

conn

(IN) Specifies the NetWare server connection handle.

dirHandle

(IN) Specifies the NetWare directory handle associated with the directory path for which the effective rights are desired (0 if the path parameter points to the complete path, including the volume name).

path

(IN) Points to the absolute path (or a path relative to the dirHandle parameter) of the directory whose effective rights mask is being returned. The characters in the string must be UTF-8.

effectiveRights

(OUT) Points to the effective rights mask for the directory. (See Remarks for a list of values.)

Return Values

These are common return values; see Return Values (Return Values for C) for more information.

Remarks

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

The current trustee rights are obtained by performing a logical OR between a trustee access mask and the trustee access mask of any object to which the process is security equivalent.

The current trustee rights 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.

The effectiveRights parameter returned to the client indicates which of the eight possible directory rights the client has in the targeted directory. An effectiveRights parameter of zero indicates the client has no rights in the target directory.

The maximum rights mask bits are defined in the table below:

NWGetEffectiveRightsExt works on files as well as directories.

NCP Calls

• 0x2222 22 3 Get Effective Directory Rights
• 0x2222 22 42 Get Effective Rights
• 0x2222 23 17 Get File Server Information
• 0x2222 87 29 Get Effective Directory Rights
• 0x2222 89 29 Get Effective Directory Rights