NWSetExtendedFileAttributes2(3nw)


NWSetExtendedFileAttributes2 -- sets extended file attributes

Synopsis

   #include <nwfile.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWSetExtendedFileAttributes2 (NWCONN_HANDLE conn, NWDIR_HANDLE dirHandle, pnstr8 path, nuint8 extAttrs);

Description

The parameters are as follows:

conn
(IN) Specifies the connection handle.

dirHandle
(IN) Specifies the directory handle of the new directory's root directory.

path
(IN) Points to the string containing the name and path of the new directory.

extAttrs
(IN) Specifies the file's extended attributes.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x898C
N0_MODIFY_PRIVILEGES

0x898D
SOME_FILES_AFFECTED_IN_USE

0x898E
NO_FILES_AFFECTED_IN_USE

0x8996
SERVER_OUT_OF_MEMORY

0x8998
VOLUME_DOES_NOT_EXIST

0x899B
BAD_DIRECTORY_HANDLE

0x899C
INVALID_PATH

0x89A1
DIRECTORY_IO_ERROR

0x89FD
BAD_STATION_NUMBER

0x89FF
Failure, NO_FILES_FOUND_ERROR

Notices

NWSetExtendedFileAttributes2 requires Search rights to the directory where the file resides.

path can specify either a file's complete path name or a path relative to the current working directory.

For example, if a file's complete path name is SYS:ACCOUNT/DOMEST/TARGET.DAT and the directory handle mapping is SYS:ACCOUNT, path could point to either of the following:

   SYS:ACCOUNT/DOMEST/TARGET.DAT or 
   DOMEST/TARGET.DAT. 
extAttrs is interpreted as follows:

Bits 0-2
Search mode bits

Bit4
Transaction bit

Bit5
Index bit (2.x only)

Bit6
Read audit bit (not yet implemented)

Bit7
Write audit bit (not yet implemented)
Setting the transaction bit prompts NetWare's Transaction Tracking System(TM) (TTS(TM)) service to track all Writes to the file during a transaction. A transaction file cannot be deleted or renamed until the transaction bit is turned off by calling NWSetExtendedFileAttributes2.

Setting the index bit prompts NetWare to index the file's File Allocation Tables (FATs), thereby reducing the time required to access files. Files larger than 2MB should have this bit set.

Services

File Systems

NCP calls

0x2222 79 Set File Extended Attribute

 
 0x2222   79   Set File Extended Attribute 

References

NWGetExtendedFileAttributes2(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.