NWAllocPermanentDirectoryHandle(3nw)


NWAllocPermanentDirectoryHandle -- allocates a permanent directory handle for a network directory

Synopsis

   #include <nwdirect.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWAllocPermanentDirectoryHandle (NWCONN_HANDLE conn, NWDIR_HANDLE dirHandle, pnstr8 dirPath, NWDIR_HANDLE N_FAR * newDirHandle, pnuint8 effectiveRights);

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 dirHandle) specifying the directory with which the new directory handle is to be associated (optional).

newDirHandle
(OUT) Points to the new directory handle.

effectiveRights
(OUT) Points to the trustee's effective rights to the directory connected via dirHandle (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

To deallocate a permanent directory handle, call NWDeallocateDirectoryHandle.

If more than 255 handles are allocated, NWAllocPermanentDirectoryHandle may return a successful code; however, dirHandle will be zero.

Services

File Systems

NCP calls

0x2222 22 03 Get Effective Directory Rights
0x2222 22 18 Alloc Permanent Directory Handle
0x2222 23 17 Get File Server Information
0x2222 87 12 Allocate Short Directory Handle

References

NWDeallocateDirectoryHandle(3nw), NWAllocTemporaryDirectoryHandle(3nw), NWAllocTempNSDirHandle(3nw), NWAllocTempNSDirHandle2(3nw),


30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.