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.