(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) of the directory or file whose effective rights mask is being reported.
rightsMask
(OUT) Points to NWRIGHTS_MASK.
Return values
0x0000
SUCCESSFUL
0x8801
INVALID_CONNECTION
0x8998
VOLUME_DOES_NOT_EXIST
0x899B
BAD_DIRECTORY_HANDLE
0x899C
INVALID_PATH
Notices
NWGetObjectEffectiveRights replaces NWGetEffectiveDirectoryRights from previous versions of NWCalls.
The maximum rights mask bits are defined below:
Hex
Bit Definition
0x01
TA_Read
0x02
TA_Write
0x08
TA_Create
0x10
TA_Delete
0x20
TA_Ownership
0x40
TA_Search
0x80
TA_Modify
To determine the requesting workstation's effective rights, NWGetObjectEffectiveRights performs a logical AND between the maximum rights mask of the directory and the
workstation's current trustee rights.
The workstation's current trustee rights are obtained by performing a logical OR between a workstation's trustee access mask and the trustee access mask of any object to which
the process is security equivalent.
The workstation's current trustee rights 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.
rightsMask returned to the client indicates which of the eight possible directory rights the client has in the targeted directory. A rightsMask of zero
indicates the client has no rights in the target directory.