NWSetDirectoryInformation(3nw)


NWSetDirectoryInformation -- changes information about directory

Synopsis

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

NWCCODE N_API NWSetDirectoryInformation (NWCONN_HANDLE conn, NWDIR_HANDLE dirHandle, pnstr8 path, nuint32 dirDateTime, nuint32 ownerID, nuint8 rightsMask);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

dirHandle
(IN) Specifies the NetWare directory handle (index) pointing to the directory (or partial directory) whose information is being set.

path
(IN) Points to the directory path of the directory being changed.

dirDateTime
(IN) Specifies the new creation date and time.

ownerID
(IN) Specifies the bindery object ID of the owner who created the directory.

rightsMask
(IN) Specifies the new maximum rights mask for the directory.

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

0x89FF
Failure, NO_FILES_FOUND_ERROR

Notices

NWSetDirectoryInformation defines the target directory by passing a directory handle and a directory path.


NOTE: Volume information for 2.x servers cannot be modified; dirDateTime and ownerID cannot be set for volumes on 2.x servers.

dirHandle, an index number from 1 to 255, points to a volume or a directory on the NetWare server. A NetWare server maintains a Directory Handle Table for each logged in workstation.

path can identify a full or partial directory path. A full directory path defines a volume or a directory on a given NetWare server in the format VOLUME:DIRECTORY/.../DIRECTORY. A partial directory path specifies at least a directory, and possibly one or more parent directories. The string accessed by path can contain wildcard characters.

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

Applications frequently combine a directory handle and a directory path to specify a target directory. For example, if the specified directory handle points to SYS: and the specified directory path is PUBLIC/WORDP, the specified directory is SYS:PUBLIC/WORDP.

dirDateTime appears in standard DOS format. The first two bytes contain the year, month, and day fields, and the second two bytes contain the hour, minute, and second fields.

NWSetDirectoryInformation sets the date and time in ascending order (byte 1, byte 2, byte 3, byte 4). The date and time values are defined as follows:

Year
0=1980, 1=1981, ..., 119=2099

Month
1 to 12

Day
1 to 31

Hour
0 to 23

Minute
0 to 59

Second
0 to 29 (in units of 2 seconds)
ownerID contains the Bindery object ID of the user who created the subdirectory.

rightsMask contains the subdirectory's maximum rights mask. The bits in the maximum rights mask are defined as follows:

0x00
TA_NONE

0x01
TA_READ

0x02
TA_WRITE

0x04
TA_OPEN

0x08
TA_CREATE

0x10
TA_DELETE

0x20
TA_OWNERSHIP

0x40
TA_SEARCH

0x80
TA_MODIFY

0xFB
TA_ALL


NOTE: TA_OPEN is obsolete in version 3.x.

To change a directory's information, the requesting workstation must have parental and modify rights to the directory's parent. Only SUPERVISOR can change the owner of a directory.

Services

File Systems

NCP calls

0x2222 22 25 Set Directory Information
0x2222 23 17 Get File Server Information
0x2222 87 07 Modify File Or Subdirectory DOS Information

 
 0x2222   22   25   Set Directory 
                    Information 
 0x2222   23   17   Get File Server 
                    Information 
 0x2222   87   07   Modify File Or 
                    Subdirectory 
                    DOS Information 

30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.