Allocates a permanent directory handle for a network directory
#include <nwdirect.h>
or
#include <nwcalls.h>
N_EXTERN_LIBRARY( NWCCODE )NWAllocPermanentDirectoryHandle (
NWCONN_HANDLE conn,
NWDIR_HANDLE dirHandle,
const nstr8 N_FAR *dirPath,
NWDIR_HANDLE N_FAR *newDirHandle,
pnuint8 effectiveRights);
uses calwin32
Function NWAllocPermanentDirectoryHandle
(conn : NWCONN_HANDLE;
dirHandle : NWDIR_HANDLE;
const dirPath : pnstr8;
Var newDirHandle : NWDIR_HANDLE;
effectiveRights : pnuint8
) : NWCCODE;
(IN) Specifies the NetWare server connection handle.
(IN) Specifies the directory handle associated with the desired directory path.
(IN) Points to an absolute directory path (or a path relative to the dirHandle parameter) specifying the directory with which the new directory handle is to be associated (optional).
(OUT) Points to the new directory handle.
(OUT) Points to the effective rights of the directory trustee connected through the dirHandle parameter (optional).
These are common return values; see Return Values (Return Values for C) for more information.
To deallocate a permanent directory handle, call the NWDeallocateDirectoryHandle function.
If more than 255 handles are allocated, NWAllocPermanentDirectoryHandle may return a successful code; however, the dirHandle parameter will be zero.