NWAFPGetFileInformation

Returns AFP information for a directory or file

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 NWAFPGetFileInformation ( 
     NWCONN_HANDLE            conn,  
     nuint16                  volNum,  
     nuint32                  AFPEntryID,  
     nuint16                  reqMask,  
     const nstr8 N_FAR       *AFPPathString,  
     nuint16                  structSize,  
     NW_AFP_FILE_INFO N_FAR  *AFPFileInfo);
  

Delphi Syntax

  uses calwin32 
   
  Function NWAFPGetFileInformation 
    (conn : NWCONN_HANDLE; 
     volNum : nuint16; 
     AFPEntryID : nuint32; 
     reqMask : nuint16; 
     const AFPPathString : pnstr8; 
     structSize : nuint16; 
     Var AFPFileInfo : NW_AFP_FILE_INFO 
  ) : 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 unique AFP base ID.
reqMask
(IN) Specifies the request bit mask information.
AFPPathString
(IN) Points to the AFP directory path relative to AFPEntryID.
structSize
(IN) Specifies the request AFPFILEINFO buffer size.
AFPFileInfo
(OUT) Points to AFPFILEINFO returning AFP file information.

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

0x8983

IO_ERROR_NETWORK_DISK

0x8993

NO_READ_PRIVILEGES

0x8996

SERVER_OUT_OF_MEMORY

0x8998

VOLUME_DOES_NOT_EXIST

0x899C

INVALID_PATH

0x89A1

DIRECTORY_I/O_ERROR

0x89A2

READ_FILE_WITH_RECORD_LOCKED

0x89FD

BAD_STATION_NUMBER

0x89FF

Failure. NO_FILES_FOUND_ERROR

Remarks

Valid bit map information request values follow for reqMask : (Bits can be ORed together.)

C Values

Delphi Values

Value Names

0x0001

$0001

AFP_GET_ATTRIBUTES

0x0002

$0002

AFP_GET_PARENT_ID

0x0004

$0004

AFP_GET_CREATE_DATE

0x0008

$0008

AFP_GET_ACCESS_DATE

0x0010

$0010

AFP_GET_MODIFY_DATETIME

0x0020

$0020

AFP_GET_BACKUP_DATETIME

0x0040

$0040

AFP_GET_FINDER_INFO

0x0080

$0080

AFP_GET_LONG_NAME

0x0100

$0100

AFP_GET_ENTRY_ID

0x0200

$0200

AFP_GET_DATA_LEN

0x0400

$0400

AFP_GET_RESOURCE_LEN

0x0800

$0800

AFP_GET_NUM_OFFSPRING

0x1000

$1000

AFP_GET_OWNER_ID

0x2000

$2000

AFP_GET_SHORT_NAME

0x4000

$4000

AFP_GET_ACCESS_RIGHTS

0x8000

$8000

AFP_GET_PRO_DOS_INFO

0xffff

$ffff

AFP_GET_ALL

NCP Calls

See Also

NWAFPSetFileInformation, NWAFPScanFileInformation