NWModifyMaximumRightsMask

Modifies the maximum rights mask of a directory

NetWare Server:3.11, 3.12, 3.2, 4.x, 5.x, 6.x
Platform:Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:File System

Syntax

   #include <nwdirect.h> 
   or 
   #include <nwcalls.h> 
    
   N_EXTERN_LIBRARY(NWCCODE) NWModifyMaximumRightsMask ( 
      NWCONN_HANDLE       conn,  
      NWDIR_HANDLE        dirHandle,  
      const nstr8 N_FAR  *path,  
      nuint8              revokeRightsMask,  
      nuint8              grantRightsMask);

Delphi Syntax

   uses calwin32 
    
   Function NWModifyMaximumRightsMask 
     (conn : NWCONN_HANDLE; 
      dirHandle : NWDIR_HANDLE; 
      const path : pnstr8; 
      revokeRightsMask : nuint8; 
      grantRightsMask : nuint8 
   ) : NWCCODE;

Parameters

conn

(IN) Specifies the NetWare server connection handle.

dirHandle

(IN) Specifies the directory handle for the directory whose maximum rights mask is being modified (or 0 if the path parameter points to the complete path, including the volume name).

path

(IN) Points to the absolute directory path (or a path relative to the directory handle) of the directory whose maximum rights mask is being modified.

revokeRightsMask

(IN) Specifies the rights being revoked.

grantRightsMask

(IN) Specifies the rights being granted.

Return Values

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

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x898C

NO_MODIFY_PRIVILEGES

0x8996

SERVER_OUT_OF_MEMORY

0x8998

VOLUME_DOES_NOT_EXIST

0x899B

BAD_DIRECTORY_HANDLE

0x899C

INVALID_PATH

0x89A1

DIRECTORY_IO_ERROR

0x89FD

BAD_STATION_NUMBER

0x89FF

Failure

Remarks

To modify the maximum rights mask for a directory, the requesting workstation must have access control rights to the directory.

The maximum rights mask follows:

Hex

Bit Definition

0x01

TA_READ

0x02

TA_WRITE

0x08

TA_CREATE

0x10

TA_DELETE

0x20

TA_OWNERSHIP

0x40

TA_SEARCH

0x80

TA_MODIFY

The rights specified by the revokeRightsMask parameter are deleted from the maximum rights mask for the directory, and the rights specified by the grantRightsMask parameter are added.

The maximum rights mask can be completely reset by setting the revokeRightsMask parameter to 0xFF and then setting the grantRightsMask parameter to the desired maximum rights mask. Maximum rights affect the specified directory only and are not inherited by subdirectories.

To return the current rights value, call NWIntScanDirectoryInformation2.

NCP Calls

See Also

NWGetEffectiveRights