NWAllocTemporaryDirectoryHandle(3nw)
NWAllocTemporaryDirectoryHandle --
assigns a temporary directory handle
Synopsis
#include <nwdirect.h>
or
#include <nwcalls.h>
NWCCODE N_API NWAllocTemporaryDirectoryHandle
(NWCONN_HANDLE conn,
NWDIR_HANDLE dirHandle,
pnstr8 dirPath,
NWDIR_HANDLE N_FAR
newDirHandle,
pnuint8 rightsMask);
Description
The parameters are as follows:
- conn
-
(IN) Specifies the NetWare server connection handle.
- dirHandle
-
(IN) Specifies the directory handle associated with the desired directory path.
- dirPath
-
(IN) Points to an absolute directory path (or a path relative to the NetWare directory handle) specifying the directory with which the new directory handle is associated.
- newDirHandle
-
(OUT) Points to the new directory handle.
- rightsMask
-
(OUT) Points to the trustee's effective rights to the directory connected via newDirHandle
(optional).
Return values
- 0x0000
-
SUCCESSFUL
- 0x8801
-
INVALID_CONNECTION
- 0x8996
-
SERVER_OUT_OF_MEMORY
- 0x8998
-
VOLUME_DOES_NOT_EXIST
- 0x8999
-
DIRECTORY_FULL
- 0x899B
-
BAD_DIRECTORY_HANDLE
- 0x899C
-
INVALID_PATH
- 0x899D
-
NO_MORE_DIRECTORY_HANDLES
- 0x89A1
-
DIRECTORY_IO_ERROR
- 0x89FD
-
BAD_STATION_NUMBER
- 0x89FF
-
INVALID_DRIVE_NUMBER, HARDWARE_FAILURE
Notices
The directory handles allocated by NWAllocTemporaryDirectoryHandle are automatically deallocated when the task terminates, or when NWDeallocateDirectoryHandle
is called.
dirHandle can be zero if dirPath points to the complete path, including the volume name.
If more than 255 handles are allocated, NWAllocTemporaryDirectoryHandle may return a successful code; however, dirHandle will be zero.
Services
File Systems
NCP calls
0x2222 22 03 Get Effective Directory Rights
0x2222 22 19 Allocate Temporary Directory Handle
0x2222 23 17 Get File Server Information
0x2222 87 12 Allocate Short Directory Handle
References
NWDeallocateDirectoryHandle(3nw),
NWAllocPermanentDirectoryHandle(3nw),
NWAllocTempNSDirHandle(3nw),
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.