NWModifyMaximumRightsMask(3nw)


NWModifyMaximumRightsMask -- modifies a directory's maximum rights mask

Synopsis

   #include<nwdirect.h> 
   or 
   #include<nwcalls.h> 
   

NWCCODE N_API NWModifyMaximumRightsMask (NWCONN_HANDLE conn, NWDIR_HANDLE dirHandle, pnstr8 path, nuint8 revokeRightsMask, nuint8 grantRightsMask);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

dirHandle
(IN) Specifies the directory handle for the directory whose maximum rights mask is being modified.

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

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x898C
N0_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

Notices

To modify a directory's maximum rights mask, the requesting workstation must have parental rights to the directory.

The maximum rights mask is defined as 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

 
 ----------------------- 
| Hex |  Bit Definition| 
|-----|----------------| 
| 0x01|  TA_READ       | 
|-----|----------------| 
| 0x02|  TA_WRITE      | 
|-----|----------------| 
| 0x08|  TA_CREATE     | 
|-----|----------------| 
| 0x10|  TA_DELETE     | 
|-----|----------------| 
| 0x20|  TA_OWNERSHIP  | 
|-----|----------------| 
| 0x40|  TA_SEARCH     | 
|-----|----------------| 
| 0x80|  TA_MODIFY     | 
|-----|----------------| 

revokeRightsMask rights are deleted from the directory's maximum rights mask, and grantRightsMask rights are added.

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

dirHandle can be zero if path points to the complete path, including the volume name.

Services

File Systems

NCP calls

0x2222 22 04
Modify Maximum Rights Mask

0x2222 23 17
Get File Server Information

0x2222 87 07
Modify File or SubDirectory DOS Information

References

NWGetEffectiveRights(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.