Assigns a temporary directory handle for the current name space
#include <nwdirect.h>
or
#include <nwcalls.h>
N_EXTERN_LIBRARY(NWCCODE) NWAllocTemporaryDirectoryHandle (
NWCONN_HANDLE conn,
NWDIR_HANDLE dirHandle,
const nstr8 N_FAR *dirPath,
NWDIR_HANDLE N_FAR *newDirHandle,
pnuint8 rightsMask);
uses calwin32
Function NWAllocTemporaryDirectoryHandle
(conn : NWCONN_HANDLE;
dirHandle : NWDIR_HANDLE;
const dirPath : pnstr8;
Var newDirHandle : NWDIR_HANDLE;
rightsMask : pnuint8
) : NWCCODE;
(IN) Specifies the NetWare server connection handle.
(IN) Specifies the directory handle associated with the desired directory path (or 0 if the dirPath parameter points to the complete path, including the volume name).
(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.
(OUT) Points to the new directory handle.
(OUT) Points to the effective rights of the directory trustee connected through the newDirHandle parameter (optional).
These are common return values; see Return Values (Return Values for C) for more information.
The directory handles allocated by NWAllocTemporaryDirectoryHandle are automatically deallocated when the task terminates, or when the NWDeallocateDirectoryHandle function is called.
If more than 255 handles are allocated, NWAllocTemporaryDirectoryHandle may return a successful code; however, the dirHandle parameter will be zero.