NWSetFileAttributes(3nw)

NWSetFileAttributes -- modifies file's original attributes

Synopsis

   #include <nwfile.h> 
   or 
   #include <nwcalls.h> 
    
   NWCCODE N_API NWSetFileAttributes 
     (NWCONN_HANDLE   conn, 
      NWDIR_HANDLE    dirHandle, 
      pnstr8          fileName, 
      nuint8          searchAttrs, 
      nuint8          newAttrs);

Description

The parameters are as follows:

conn: (IN) Specifies the NetWare server connection handle containing the file.
dirHandle: (IN) Specifies the NetWare directory handle.
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 dirHandle and pbstrFileName.

Return values

0x0000: SUCCESSFUL
0x8801: INVALID_CONNECTION
0x898C: N0_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

Notices

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

fileName can specify either a file's complete path name or a path relative to the current working directory. For example, if a complete path name is SYS:ACCOUNT/DOMEST/TARGET.DAT and the directory handle mapping is SYS:ACCOUNT, fileName could point to either of the following:

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

In the first example, where fileName points to the complete path, dirHandle could be set to zero. If the directory handle is 0, the file name must contain the full path, including the volume name.

searchAttrs includes 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 either 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 17 Get File Server Information

0x2222 70 - Set File Attributes

0x2222 87 07 Modify File Or Subdirectory DOS Information

 
 0x2222   23   17   Get File Server 
                    Information 
 0x2222   70   -    Set File 
                    Attributes 
 0x2222   87   07   Modify File Or 
                    Subdirectory 
                    DOS Information

References

NWGetExtendedFileAttributes2(3nw), NWSetFileInformation2(3nw)

0x2222	23	17	Get File Server Information
0x2222	70	-	Set File Attributes
0x2222	87	07	Modify File Or Subdirectory DOS Information