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.