NWAFPScanFileInformation(3nw)


NWAFPScanFileInformation -- scans directory and returns AFP file/directory information

Synopsis

   #include <nwafp.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE NWAPI NWAFPScanFileInformation (NWCONN_HANDLE conn, nuint16 volNum, nuint32 AFPEntryID, pnuint32 AFPLastSeenID, nuint16 searchMask, nuint16 reqMask, pnstr8 AFPPathString, nuint16 structSize, NW_AFP_FILE_INFO N_FAR * AFPFileInfo);

Description

The parameters are as follows:

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

0x0000
SUCCESSFUL

0x8801
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

Notices

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

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

0x0001
AFP_GET_ATTRIBUTES

0x0002
AFP_GET_PARENT_ID

0x0004
AFP_GET_CREATE_DATE

0x0008
AFP_GET_ACCESS_DATE

0x0010
AFP_GET_MODIFY_DATETIME

0x0020
AFP_GET_BACKUP_DATETIME

0x0040
AFP_GET_FINDER_INFO

0x0080
AFP_GET_LONG_NAME

0x0100
AFP_GET_ENTRY_ID

0x0200
AFP_GET_DATA_LEN

0x0400
AFP_GET_RESOURCE_LEN

0x0800
AFP_GET_NUM_OFFSPRING

0x1000
AFP_GET_OWNER_ID

0x2000
AFP_GET_SHORT_NAME

0x4000
AFP_GET_ACCESS_RIGHTS

0x8000
AFP_GET_PRO_DOS_INFO

0xffff
AFP_GET_ALL
NWSEARCH_MASK is defined as follows:

0x0000
AFP_SA_NORMAL

0x0100
AFP_SA_HIDDEN

0x0200
AFP_SA_SYSTEM

0x0400
AFP_SA_SUBDIR

0x0800
AFP_SA_FILES

0xF000
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 

Services

AppleTalk Filing Protocol

NCP calls

0x2222 35 17 AFP 2.0 Scan File Information

References

NWAFPGetFileInformation(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.