ModifyInheritedRightsMask

Syntax

   #include <nwdir.h> 
    
    int ModifyInheritedRightsMask (  
       char  *path, 
       WORD   revokeRightsMask, 
       WORD   grantRightsMask);
   

Parameters

path

(IN) Specifies the string containing the path specification for the directory or file to be modified (maximum 255 characters, including the NULL terminator).

revokeRightsMask

(IN) Specifies the rights mask that specifies which rights in the directory’s inherited rights mask are to be modified.

grantRightsMask

(IN) Specifies the rights mask to receive the modified rights.

Return Values

Remarks

For remote server support, this function returns the maximum rights mask for NetWare 2.x.

The ModifyInheritedRightsMask function specifies the directory or file by passing a pathname. The path parameter can identify an absolute or relative directory or file path. An absolute path includes a volume.

Examples of absolute pathnames would be:

Applications can use a relative file path to specify a directory or file. The relative path, combined with the CWD, specifies an absolute file path. For example, if the CWD points to SYS:\ and the specified pathname is PUBLIC\WORDP or PUBLIC\WORDP\ABC.TXT, then in the former case, the resulting directory is SYS:PUBLIC\WORDP and in the latter case, SYS:PUBLIC\WORDP\ABC.TXT.

The function specifies which rights to modify by passing the revokeRightsMask .

Both the grantRightsMask and the revokeRightsMask are 1-WORD parameters with bits defined as follows:

• 0 Read (file reads allowed)
• 1 Write (file writes allowed)
• 2 Reserved
• 3 Create (files can be created)
• 4 Delete (files can be deleted)
• 5 Access control (trustee rights can be assigned)
• 6 See files (files can be viewed in directory scan)
• 7 Modify (files can be modified)
• 8 Supervisor (all rights are granted)

The grantRightsMask and the revokeRightsMask parameters are both single-byte parameters for NetWare 2.x remote server support. There is no Supervisor bit for NetWare 2.x servers.

• 0 Read (file reads allowed)
• 1 Write (file writes allowed)
• 2 Open
• 3 Create (files can be created)
• 4 Delete (files can be deleted)
• 5 Parental (subdirectories can be created/deleted and trustee rights granted/revoked)
• 6 Search (directory can be searched)
• 7 Modify (file attributes can be modified)

The rights in the directory’s inherited rights mask are modified according to the revokeRightsMask and are placed in the grantRightsMask . The inherited rights mask can be completely reset by setting the revokeRightsMask to 0xFF and then setting the grantRightsMask to the desired inherited rights mask.

The current connection must have access control rights to the directory or file whose inherited rights mask is being modified.

SetCurrentNameSpace sets the name space which is used for parsing the path input to this function.

See Also

GetEffectiveRights