NWAFPGetFileInformation(3nw)
NWAFPGetFileInformation --
returns AFP information for directory or file
Synopsis
#include <nwafp.h>
or
#include <nwcalls.h>
NWCCODE NWAPI NWAFPGetFileInformation
(NWCONN_HANDLE conn,
nuint16 volNum,
nuint32 AFPEntryID,
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 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
- 0x0000
-
SUCCESSFUL
- 0x8801
-
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
Notices
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
Services
AppleTalk Filing Protocol
NCP calls
0x2222 35 15 AFP 2.0 Get File
References
NWAFPSetFileInformation(3nw),
NWAFPScanFileInformation(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.