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.