SetDirectoryInfo

Syntax

   #include <nwdir.h> 
    
    int SetDirectoryInfo (  
       char  *directoryPath, 
       BYTE  *newCreationDateAndTime, 
       LONG   newOwnerObjectID, 
       WORD   newInheritedRightsMask);
   

Parameters

directoryPath

(IN) Specifies the string containing the path for the directory whose information is changed (maximum 255 characters, including the NULL terminator).

newCreationDateAndTime

(IN) Specifies the date and time that the directory was created (standard DOS format, 4 bytes).

newOwnerObjectID

(IN) Specifies the unique object ID of the new owner of the directory.

newInheritedRightsMask

(IN) Specifies the new inherited rights mask of the directory.

Return Values

Remarks

The newInheritedRightsMask parameter only specifies additional rights to be granted. Call ModifyInheritedRightsMask to revoke rights.

This function specifies a creation date and time, owner object ID, and inherited rights mask. The function defines the target directory by passing a partial or complete path.

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 creationDateAndTime parameter appears in standard DOS format as follows:

The function returns the date and time in ascending order (byte 1, byte 2, byte 3, byte 4).

The newOwnerObjectID parameter contains the object ID of the directory owner.

The newInheritedRightsMask parameter contains the directory’s inherited rights mask. The bits in the inherited rights mask are 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 following constants have been defined for each right which can be ORed (|) together for a complete specification:

• TA_READ
• TA_WRITE
• TA_CREATE
• TA_DELETE
• TA_ACCESSCONTROL
• TA_SEEFILES
• TA_MODIFY
• TA_SUPERVISOR

To change a directory’s information, the current connection must have access control and modify rights to the directory’s parent.

The SUPERVISOR or supervisor equivalent are the only users that can change the owner of a directory.

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