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.