NWSetExtendedFileAttributes2

Syntax

   #include <nwfile.h> 
   or 
   #include <nwcalls.h> 
    
   N_EXTERN_LIBRARY(NWCCODE) NWSetExtendedFileAttributes2 ( 
      NWCONN_HANDLE       conn,  
      NWDIR_HANDLE        dirHandle,  
      const nstr8 N_FAR  *path,  
      nuint8              extAttrs);
   

Delphi Syntax

   uses calwin32 
    
   Function NWSetExtendedFileAttributes2 
     (conn : NWCONN_HANDLE; 
      dirHandle : NWDIR_HANDLE; 
      path : pnstr8; 
      extAttrs : nuint8 
   ) : NWCCODE;
   

Parameters

conn

(IN) Specifies the connection handle.

dirHandle

(IN) Specifies the directory handle of the root directory of the new directory..

path

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

extAttrs

(IN) Specifies the extended attributes for the file.

Return Values

These are common return values; see Return Values (Return Values for C) for more information.

Remarks

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

The path parameter can specify either the complete path name for a file or a path relative to the current working directory.

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

   SYS:/ACCOUNT/DOMEST/TARGET.DAT or DOMEST/TARGET.DAT
   

The bit map for the extAttrs parameter follows:

Setting the transaction bit prompts TTS™ 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 Allocation Tables for the file, thereby reducing the time required to access files. Files larger than 2 MB should have this bit set.

NCP Calls

• 0x2222 79 Set File Extended Attribute

See Also

NWGetExtendedFileAttributes2, NWSetNSEntryDOSInfo