NWGetExtendedFileAttributes2(3nw)


NWGetExtendedFileAttributes2 -- returns a specified file's NetWare extended file attributes

Synopsis

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

NWCCODE N_API NWGetExtendedFileAttributes2 (NWCONN_HANDLE conn, NWDIR_HANDLE dirHandle, pnstr8 path, pnuint8 extAttrs);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

dirHandle
(IN) Specifies the directory handle of the new directory's root directory.

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

extAttrs
(OUT) Points to the file's extended attributes.

Return values

0x000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8988
INVALID_FILE_HANDLE

0x8989
NO_SEARCH_PRIVILEGES

0x8993
NO_READ_RRIVILEGES

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

0x89FD
BAD_STATION_NUMBER

0x89FF
NO_FILES_FOUND_ERROR

Notices

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

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

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

The information accessed by extAttrs is interpreted as follows:

Bits Function
0-2 Search mode bits
4 Transaction bit
5 Index bit
6 Read audit bit
7 Write audit bit

 
 --------------------------------------- 
| Bits|  Function                      | 
|-----|--------------------------------| 
| 0-2 |  Search mode bits              | 
|-----|--------------------------------| 
| 4   |  Transaction bit               | 
|-----|--------------------------------| 
| 5   |  Index bit                     | 
|-----|--------------------------------| 
| 6   |  Read audit bit                | 
|-----|--------------------------------| 
| 7   |  Write audit bit               | 
|-----|--------------------------------| 

Services

File Systems

NCP calls

0x2222 23 15
Scan File Information

References

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