NWSetFileInformation2(3nw)


NWSetFileInformation2 -- updates file information

Synopsis

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

NWCCODE N_API NWSetFileInformation2 (NWCONN_HANDLE conn, NWDIR_HANDLE dirHandle, pnstr8 fileName, nuint8 searchAttrs, NW_FILE_INFO2 N_FAR * info);

Description

The parameters are as follows:

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

dirHandle
(IN) Specifies the NetWare directory handle.

fileName
(IN) Points to the name of the file to modify.

searchAttrs
(IN) Specifies the search attributes.

info
(IN) Points to NW_FILE_INFO2.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8988
INVALID_FILE_HANDLE

0x898C
N0_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

Notices

NWSetFileInformation2 handles long names (up to 256 bytes).

dirHandle can be zero if fileName points to the complete path, including the volume name.

NWSetFileInformation2 sets the file information defined by NW_FILE_INFO2.

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

   SYS:ACCOUNT/DOMEST/TARGET.DAT 
   DOMEST/TARGET.DAT 
searchAttrs is used to include system and/or hidden files. In other words, if only the system bit is set in searchAttrs, 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.

searchAttrs values follow:

0x00
FA_NORMAL

0x01
FA_READ_ONLY

0x02
FA_HIDDEN

0x04
FA_SYSTEM

0x08
FA_EXECUTE_ONLY

0x10
FA_DIRECTORY

0x20
FA_NEEDS_ARCHIVED

0x80
FA_SHAREABLE

Services

File Systems

NCP calls

0x2222 23 16 Set File Information
0x2222 23 17 Get File Server Information
0x2222 87 07 Modify File Or Subdirectory DOS Information

 
 0x2222   23   16   Set File 
                    Information 
 0x2222   23   17   Get File Server 
                    Information 
 0x2222   87   07   Modify File Or 
                    Subdirectory 
                    DOS Information 

References

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