NWSetFileAttributes

Modifies a file’s original attributes

NetWare Server:3.11, 3.12, 3.2, 4.x, 5.x, 6.x
Platform:Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:File System

Syntax

   #include <nwfile.h> 
   or 
   #include <nwcalls.h> 
    
   N_EXTERN_LIBRARY(NWCCODE) NWSetFileAttributes ( 
      NWCONN_HANDLE       conn,  
      NWDIR_HANDLE        dirHandle,  
      const nstr8 N_FAR  *fileName,  
      nuint8              searchAttrs, 
      nuint8              newAttrs);
   

Delphi Syntax

   uses calwin32 
    
   Function NWSetFileAttributes 
     (conn : NWCONN_HANDLE; 
      dirHandle : NWDIR_HANDLE; 
      fileName : pnstr8; 
      searchAttrs : nuint8; 
      newAttrs : nuint8 
   ) : NWCCODE;
   

Parameters

conn

(IN) Specifies the NetWare server connection handle containing the file.

dirHandle

(IN) Specifies the NetWare directory handle (0 if the fileName parameter points to the complete path, including the volume name).

fileName

(IN) Points to the string containing a path name, relative to dirHandle.

searchAttrs

(IN) Specifies the attributes to use in searching for a file.

newAttrs

(IN) Specifies the new attributes to be applied to the file designated by the dirHandle and fileName parameters.

Return Values

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

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x898C

NO_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

Remarks

The fileName parameter can specify either a complete path name 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 fileName parameter could point to either of the following:

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

The searchAttrs parameter includes system and/or hidden files. If only the system bit is set in the searchAttrs parameter, all files are affected except hidden files. If only the hidden bit is set, all files are affected except system files. When neither bit is set (0x00), only files that are not designated either hidden or system are affected.

NOTE:A file is designated hidden or system if its corresponding file attribute is set.

The searchAttrs parameter can have the following values:

C Value

Delphi Value

Value Name

0x00

$00

FA_NORMAL

0x01

$01

FA_READ_ONLY

0x02

$02

FA_HIDDEN

0x04

$04

FA_SYSTEM

0x08

$08

FA_EXECUTE_ONLY

0x10

$10

FA_DIRECTORY

0x20

$20

FA_NEEDS_ARCHIVED

0x80

$80

FA_SHAREABLE

NCP Calls

See Also

NWGetExtendedFileAttributes2, NWIntScanFileInformation2, NWSetFileInformation2, NWSetNSEntryDOSInfo