SetExtendedFileAttributes

Sets the extended attributes byte for a file

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.x, 4.x, 5.x, 6.x
Platform:NLM
Service:File System

Syntax

   #include <nwfinfo.h>  
    
   int SetExtendedFileAttributes  (  
      char  *filePath,   
      BYTE   extendedFileAttributes);

Parameters

filePath

(IN) Specifies the string containing the relative or absolute (including the volume name) path specification of the file whose extended attributes are being changed (maximum 255 characters, including the NULL terminator).

extendedFileAttributes

(IN) Specifies the new extended attributes for the file.

Return Values

0

0x00

ESUCCESS

254

0xFE

ERR_INCORRECT_ACCESS_PRIVILEGES

255

0xFF

ERR_NO_FILES_FOUND

Remarks

SetExtendedFileAttributes sets the extended file attributes for a file by passing a file path and an extended file attributes byte. The current connection must have Modify rights to the file.

SetExtendedFileAttributes overwrites the first byte of the existing file attributes with the value in the extendedFileAttributes parameter. The byte definition follows:

If the Transaction bit is set in the extendedFileAttributes parameter byte, TTS tracks 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 SetExtendedFileAttributes.

NOTE:Do not confuse the first attributes byte with true extended attributes, which can be manipulated by calling the Extended Attribute functions.

The SetCurrentNameSpace function sets the name space which is used for parsing the path input to SetExtendedFileAttributes.

NOTE:For NetWare versions before 4.x, SetExtendedFileAttributes works only with the DOS name space for remote servers.

See Also

GetExtendedFileAttributes