NWAllocTempNSDirHandle(3nw)
NWAllocTempNSDirHandle --
assigns a temporary directory handle for dirHandle/path
Synopsis
#include <nwnamspc.h>
or
#include <nwcalls.h>);
NWCCODE N_API NWAllocTempNSDirHandle
(NWCONN_HANDLE conn,
nuint8 dirHandle,
pnstr8 path,
nuint8 namSpc,
nuint8 N_FAR
newDirHandle);
Description
The parameters are as follows:
- conn
-
(IN) Specifies the NetWare
server connection handle through which to attach.
- dirHandle
-
(IN) Specifies the directory handle associated with the desired directory path.
- path
-
(IN) Points to an absolute path, (or relative if dirHandle is non-zero), with which newDirHandle is to be associated.
- nameSpc
-
(IN) Specifies the name space of dirHandle/path.
- newDirHandle
-
(OUT) Points to the new directory handle.
Return values
- 0x0000
-
SUCCESSFUL
- 0x8801
-
INVALID_CONNECTION
- 0x8998
-
VOLUME_DOES_NOT_EXIST
- 0x899B
-
BAD_DIRECTORY_HANDLE
- 0x899C
-
INVALID_PATH
- 0x89BF
-
INVALID_NAME_SPACE
Notices
To allocate dirHandle in a different name space, call NWAllocTempNSDirHandle2. In order for this function to perform properly it is required that the
specified name space be loaded on the server being accessed. For example, if an OS/2 workstation calls this function with the nameSpace parameter set to OS/2, the
newNameSpace parameter set to DOS and the server being accessed does not have the OS/2 name space loaded this function will not work.
To allocate OS/2, dirHandle/path must use the OS/2 format.
The directory handles allocated by NWAllocTempNSDirHandle are automatically deallocated when the task terminates or by calling NWDeallocateDirectoryHandle.
Services
Name Space
NCP calls
0x2222 87 12 Allocate Short Directory Handle
References
NWAllocTempNSDirHandle2(3nw),
NWDeallocateDirectoryHandle(3nw),
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.