NWAFPSetFileInformation(3nw)
NWAFPSetFileInformation --
sets AFP information for file or directory
Synopsis
#include <nwafp.h>
or
#include <nwcalls.h>
NWCCODE NWAPI NWAFPSetFileInformation
(NWCONN_HANDLE conn,
nuint16 volNum,
nuint32 AFPBaseID,
nuint16 reqMask,
pnstr8 AFPPathString,
nuint16 structSize,
NW_AFP_SET_INFO N_FAR
AFPSetInfo);
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.
- AFPBaseID
-
(IN) Specifies the AFP base ID.
- reqMask
-
(IN) Specifies the request bit mask information.
- AFPPathString
-
(IN) Points to the AFP directory path relative to AFPBaseID.
- structSize
-
(IN) Specifies the size of the AFPSETINFO buffer.
- AFPSetInfo
-
(IN) Points to AFPSETINFO to set AFP file information.
Return values
- 0x0000
-
SUCCESSFUL
- 0x8801
-
INVALID_CONNECTION
- 0x8901
-
ERR_INSUFFICIENT_SPACE
- 0x8988
-
INVALID_FILE_HANDLE
- 0x8901
-
ERR_INSUFFICIENT_SPACE
- 0x8983
-
IO_ERROR_NETWORK_DISK
- 0x8993
-
NO_READ_PRIVILEGES
- 0x8994
-
NO_WRITE_PRIVILEGES_OR_READONLY
- 0x8995
-
FILE_DETACHED
- 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
-
Failure; NO_FILES_FOUND_ERROR
Notices
The following constants are used by NWAFPSetFileInformation to
manipulate requestMask. They are also used in by
NWSEARCH_MASK in NWAFPScanFileInformation.
- 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
These constants identify AFP entries to be included in
NWAFPSetFileInformation.
- 0x0000
-
AFP_SA_NORMAL
- 0x0100
-
AFP_SA_HIDDEN
- 0x0200
-
AFP_SA_SYSTEM
- 0x0400
-
AFP_SA_SUBDIR
- 0x0800
-
AFP_SA_FILES
- 0xF000
-
AFP_SA_ALL
Valid bit map information request values follow for reqMask
(bits can be ORed together):
- 0x0001
-
AFP_SET_ATTRIBUTES
- 0x0004
-
AFP_SET_CREATE_DATE
- 0x0008
-
AFP_SET_ACCESS_DATE
- 0x0010
-
AFP_SET_MODIFY_DATETIME
- 0x0020
-
AFP_SET_BACKUP_DATETIME
- 0x0040
-
AFP_SET_FINDER_INFO
- 0x8000
-
AFP_SET_PRO_DOS_INFO
AFPSETINFO 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 16 AFP 2.0 Set File Information
References
NWAFPGetFileInformation(3nw),
NWAFPScanFileInformation(3nw),
NWSetLongName(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.