NWAFPGetEntryIDFromPathName

Returns a unique 32-bit AFP file or directory ID, given a combination of path and directory 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 <nwafp.h> 
  or 
  #include <nwcalls.h> 
   
  NWCCODE NWAPI  NWAFPGetEntryIDFromPathName  ( 
     NWCONN_HANDLE        conn,  
     NWDIR_HANDLE         dirHandle,  
     const nstr8 N_FAR   *path,  
     pnuint32             AFPEntryID);
  

Delphi Syntax

  uses calwin32 
   
  Function NWAFPGetEntryIDFromPathName 
    (conn : NWCONN_HANDLE; 
     dirHandle : NWDIR_HANDLE; 
     const path : pnstr8; 
     AFPEntryID : pnuint32 
  ) : NWCCODE;
  

Parameters

conn
(IN) Specifies the NetWare server connection handle.
dirHandle
(IN) Specifies the directory handle for path.
path
(IN) Points to the path given relative to the directory handle.
AFPEntryID
(OUT) Points to the AFP base ID.

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

0x8983

IO_ERROR_NETWORK_DISK

0x8988

INVALID_FILE_HANDLE

0x8993

NO_READ_RRIVILEGES

0x8996

SERVER_OUT_OF_MEMORY

0x8998

VOLUME_DOES_NOT_EXIST

0x899B

BAD_DIRECTORY_HANDLE

0x899C

INVALID_PATH

0x89A1

DIRECTORY_IO_ERROR

0x89A2

READ_FILE_WITH_RECORD_LOCKED

0x89FD

BAD_STATION_NUMBER

0x89FF

NO_FILES_FOUND_ERROR

Remarks

The directory base and path specifications must be given in DOS name space format.

NCP Calls

See Also

NWAFPGetEntryIDFromHandle, NWAFPGetEntryIDFromName, NWAFPGetFileInformation, NWAFPAllocTemporaryDirHandle, NWAllocTempNSDirHandle2 (Multiple and Inter-File Services)