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(TM) 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.