NWCreateDirectory(3nw)


NWCreateDirectory -- creates a NetWare directory on the specified server

Synopsis

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

NWCCODE N_API NWCreateDirectory (NWCONN_HANDLE conn, NWDIR_HANDLE dirHandle, pnstr8 dirPath, nuint8 accessMask);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

dirHandle
(IN) Specifies the directory handle of the new directory's root directory.

dirPath
(IN) Points to the string containing the name and path of the new directory.

accessMask
(IN) Specifies the access rights mask for the new directory.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8984
NO_CREATE_PRIVILEGES

0x8996
SERVER_OUT_OF_MEMORY

0x8998
VOLUME_DOES_NOT_EXIST

0x8999
DIRECTORY_FULL

0x899B
BAD_DIRECTORY_HANDLE

0x899C
INVALID_PATH

0x899E
INVALID_FILENAME

0x89A1
DIRECTORY_IO_ERROR

0x89FD
BAD_STATION_NUMBER

0x89FF
HARDWARE_FAILURE (directory/file already exists)

Notices

dirHandle can be zero if dirPath points to the complete path of the new directory, including the volume name.

accessMask can be set using one or more of the following:

Hex Definition
0xFB TA_ALL
0x01 TA_READ
0x02 TA_WRITE
0x04 TA_OPEN
0x08 TA_CREATE
0x10 TA_DELETE
0x20 TA_OWNERSHIP
0x40 TA_SEARCH
0x80 TA_MODIFY

 
 --------------------------------------- 
| Hex |  Definition                    | 
|-----|--------------------------------| 
| 0xFB|  TA_ALL                        | 
|-----|--------------------------------| 
| 0x01|  TA_READ                       | 
|-----|--------------------------------| 
| 0x02|  TA_WRITE                      | 
|-----|--------------------------------| 
| 0x04|  TA_OPEN                       | 
|-----|--------------------------------| 
| 0x08|  TA_CREATE                     | 
|-----|--------------------------------| 
| 0x10|  TA_DELETE                     | 
|-----|--------------------------------| 
| 0x20|  TA_OWNERSHIP                  | 
|-----|--------------------------------| 
| 0x40|  TA_SEARCH                     | 
|-----|--------------------------------| 
| 0x80|  TA_MODIFY                     | 
|-----|--------------------------------| 


NOTE:

Actual rights are set according to inherited rights.


Services

File Systems

NCP calls

0x2222 22 10 Create Directory
0x2222 23 17 Get File Server Information
0x2222 87 01 Open Create File Or Subdirectory

References

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