NWSetFileInformation2

Updates file information

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) NWSetFileInformation2 (
      NWCONN_HANDLE         conn,  
      NWDIR_HANDLE          dirHandle,  
      const nstr8 N_FAR    *fileName,  
      nuint8                searchAttrs,  
      NW_FILE_INFO2 N_FAR  *info);
   

Delphi Syntax

   uses calwin32 
    
   Function NWSetFileInformation2 
     (conn : NWCONN_HANDLE; 
      dirHandle : NWDIR_HANDLE; 
      fileName : pnstr8; 
      searchAttrs : nuint8; 
      Var info : NW_FILE_INFO2 
   ) : NWCCODE;
   

Parameters

conn

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

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 name of the file to modify. The name, or complete path, must be in the long name space to work on Windows workstations.

searchAttrs

(IN) Specifies the search attributes.

info

(IN) Points to NW_FILE_INFO2.

Return Values

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

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x8988

INVALID_FILE_HANDLE

0x898C

NO_MODIFY_PRIVILEGES

0x898E

NO_FILES_AFFECTED_IN_USE

0x8994

NO_WRITE_PRIVILEGES_OR_READONLY

0x8996

SERVER_OUT_OF_MEMORY

0x8998

VOLUME_DOES_NOT_EXIST

0x899B

BAD_DIRECTORY_HANDLE

0x899C

INVALID_PATH

0x89A1

DIRECTORY_IO_ERROR

0x89A2

READ_FILE_WITH_RECORD_LOCKED

0x89FC

NO_SUCH_OBJECT

0x89FD

BAD_STATION_NUMBER

0x89FE

DIRECTORY_LOCKED

0x89FF

Failure, NO_FILES_FOUND_ERROR

Remarks

NWSetFileInformation2 handles long names (up to 256 bytes).

NWSetFileInformation2 sets the file information defined by the NW_FILE_INFO2 structure.

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 be either of the following:

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

The searchAttrs parameter is used to include 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 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, NWSetFileAttributes,