NWAFPAllocTemporaryDirHandle(3nw)


NWAFPAllocTemporaryDirHandle -- allocates a directory handle for an AFP directory

Synopsis

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

NWCCODE NWAPI NWAFPAllocTemporaryDirHandle (NWCONN_HANDLE conn, nuint16 volNum, nuint32 AFPEntryID, pnstr8 AFPPathString, NWDIR_HANDLE N_FAR * dirHandle, pnuint8 accessRights);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare® server connection handle.

volNum
(IN) Specifies the volume number of the directory entry location.

AFPEntryID
(IN) Specifies the AFP base ID.

AFPPathString
(IN) Points to the AFP style directory path relative to AFPEntryID.

dirHandle
(OUT) Points to the NetWare directory handle.

accessRights
(OUT) Points to the effective rights the requesting user has on the directory.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8805
NET_RECV_ERROR

0x8988
INVALID_FILE_HANDLE

0x8983
IO_ERROR_NETWORK_DISK

0x8993
NO_READ_PRIVILEGES

0x8996
SERVER_OUT_OF_MEMORY

0x8998
VOLUME_DOES_NOT_EXIST

0x899B
BAD_DIRECTORY_HANDLE

0x899C
INVALID_PATH

0x899D
NO_MORE_DIRECTORY_HANDLES

0x89A1
DIRECTORY_IO_ERROR

Notices

The directory handles allocated by NWAFPAllocTemporaryDirHandle are automatically deallocated when the task terminates.

Services

AppleTalk Filing Protocol

NCP calls

0x2222 35 11 AFP Alloc Temporary Directory Handle

References

NWAllocTemporaryDirectoryHandle(3nw), NWAllocTempNSDirHandle(3nw),


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