NWAFPGetEntryIDFromHandle

Returns an AFP entry ID for the specified NetWare handle

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 <nwcaldef.h> 
  or 
  #include <nwcalls.h> 
   
  NWCCODE NWAPI NWAFPGetEntryIDFromHandle ( 
     NWCONN_HANDLE        conn,  
     const nuint8 N_FAR  *NWHandle,  
     pnuint16             volNum,  
     pnuint32             AFPEntryID,  
     pnuint8              forkIndicator);
  

Delphi Syntax

  uses calwin32 
   
  Function NWAFPGetEntryIDFromHandle 
    (conn : NWCONN_HANDLE; 
     const NWHandle : pnuint8; 
     volNum : pnuint16; 
     AFPEntryID : pnuint32; 
     forkIndicator : pnuint8 
  ) : NWCCODE;
  

Parameters

conn
(IN) Specifies the NetWare server connection handle.
NWHandle
(IN) Points to the 6-byte NetWare handle for the path name.
volNum
(OUT) Points to the volume number of the directory entry location.
AFPEntryID
(OUT) Points to the AFP file entry ID.
forkIndicator
(OUT) Points to the fork indicator (0 = data; 1 = resource).

Return Values

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

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x8988

INVALID_FILE_HANDLE

0x8998

VOLUME_DOES_NOT_EXIST

0x899C

INVALID_PATH

Remarks

AFPEntryID points to the AFP file ID. It is not the AFP base ID. INVALID_PATH will be returned if you use the AFPEntryID as the AFP base ID.

NCP Calls

See Also

NWAFPGetEntryIDFromName, NWAFPGetEntryIDFromPathName, NWAFPGetFileInformation, NWAFPAllocTemporaryDirHandle