Novell Documentation: NLM & NetWare Libraries for C

NWAFPScanFileInformation

Scans a directory and returns AFP file/directory information

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

Delphi Syntax

  uses calwin32 
   
  Function NWAFPScanFileInformation 
    (conn : NWCONN_HANDLE; 
     volNum : nuint16; 
     AFPEntryID : nuint32; 
     AFPLastSeenID : pnuint32; 
     searchMask : nuint16; 
     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 AFP base ID.
AFPLastSeenID: (IN) Points to AFPEntryID.
searchMask: (IN) Specifies the search mask.
reqMask: (IN) Specifies the request bit mask information.
AFPPathString: (IN) Points to the AFP directory path relative to AFPEntryID.
structSize: (IN) Specifies the size of the AFPFILEINFO buffer.
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
0x8983	IO_ERROR_NETWORK_DISK
0x8988	INVALID_PATH
0x8993	NO_READ_PRIVILEGES
0x8996	SERVER_OUT_OF_MEMORY
0x8998	VOLUME_DOES_NOT_EXIST
0x899C	INVALID_PATH
0x89A1	DIRECTORY_IO_ERROR
0x89A2	READ_FILE_WITH_RECORD_LOCKED
0x89FD	BAD_STATION_NUMBER
0x89FF	NO_FILES_FOUND_ERROR

Remarks

AFPLastSeenID should be initialized to -1 on the first iteration.

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

NWSEARCH_MASK is defined as follows:

C Values	Delphi Values	Value Names
0x0000	$0000	AFP_SA_NORMAL
0x0100	$0100	AFP_SA_HIDDEN
0x0200	$0200	AFP_SA_SYSTEM
0x0400	$0400	AFP_SA_SUBDIR
0x0800	$0800	AFP_SA_FILES
0xF00	$0F00	AFP_SA_ALL

AFPFILEINFO attributes follow:

  0x0001 = Search Mode 
  0x0002 = Search Mode 
  0x0004 = Search Mode 
  0x0008 = Undefined 
  0x0010 = Transaction 
  0x0020 = Index 
  0x0040 = Read Audit 
  0x0080 = Write Audit 
  0x0100 = Read Only 
  0x0200 = Hidden 
  0x0400 = System 
  0x0800 = Execute Only 
  0x1000 = Subdirectory 
  0x2000 = Archive 
  0x4000 = Undefined 
  0x8000 = Shareable File

NCP Calls