NWAFPAllocTemporaryDirHandle

Allocates a directory handle for an AFP directory

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 3.2, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:AFP

Syntax

  #include <nwafp.h> 
  or 
  #include <nwcalls.h> 
   
  NWCCODE NWAPI  NWAFPAllocTemporaryDirHandle ( 
     NWCONN_HANDLE        conn,  
     nuint16              volNum,  
     nuint32              AFPEntryID,  
     constr nstr8 N_FAR  *AFPPath,  
     NWDIR_HANDLE N_FAR  *dirHandle,  
     pnuint8              accessRights);
  

Delphi Syntax

  uses calwin32 
   
  Function NWAFPAllocTemporaryDirHandle 
    (conn : NWCONN_HANDLE; 
     volNum : nuint16; 
     AFPEntryID : nuint32; 
     const AFPPathString : pnstr8; 
     Var dirHandle : NWDIR_HANDLE; 
     accessRights : pnuint8 
  ) : NWCCODE;
  

Parameters

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.
AFPPath
(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

These are common return values; see Return Values (Return Values for C) for more information.

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x8805

NET_RECV_ERROR

0x890A

NLM_INVALID_CONNECTION

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

Remarks

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

NCP Calls

See Also

NWAllocTemporaryDirectoryHandle, NWAllocTempNSDirHandle2 (Multiple and Inter-File Services)