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
|
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.