GetExtendedFileAttributes

Returns the extended attributes for a file

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.x, 4.x, 5.x, 6.x
Platform:NLM
Service:File System

Syntax

   #include <nwfileio.h>  
    
   int GetExtendedFileAttributes  (  
      char  *filePath,   
      BYTE  *extendedFileAttributes);
   

Parameters

filePath

(IN) Points to a string containing the absolute path or path relative to the current working directory of the file for which to get extended file attributes (maximum 255 characters, including the NULL terminator).

extendedFileAttributes

(OUT) Points to the extended attributes.

Return Value

0

0x00

ESUCCESS

137

0x89

ERR_NO_SEARCH_PRIVILEGE

156

0x9C

ERR_INVALID_PATH

158

0x9F

ERR_BAD_FILE_NAME

191

0xBF

ERR_INVALID_NAME_SPACE

253

0xFD

ERR_BAD_STATION_NUMBER

254

0xFE

ERR_SPOOL_DIRECTORY_ERROR

255

0xFF

ERR_NO_FILES_FOUND—The target file does not exist.

Remarks

GetExtendedFileAttributes returns the value of the first byte of the file attributes, known as the extended attributes byte. The following bits are defined:

NOTE:Do not confuse the file attributes byte with true extended attributes, which can be manipulated with the Extended Attribute functions.

If the transaction bit is set in the extendedFileAttributes parameter, NetWare TTS™ software tracks all writes to the file during a transaction. A transaction file cannot be deleted or renamed until the transaction bit is turned off with the SetExtendedFileAttributes function.

An application can specify a file in several ways. For example, suppose the full path of the file TARGET.DAT is:

   SYS:ACCOUNT\DOMEST\TARGET.DAT
   

and the current working directory is SYS:ACCOUNT. The application can specify the partial path, DOMEST\TARGET.DAT, or the full path in the filePath parameter.

GetExtendedFileAttributes requires that the current connection have See File rights to the directory where the file resides.

The SetCurrentNameSpace function sets the name space which is used for parsing the path input to GetExtendedFileAttributes.

NOTE:For NetWare versions before 4.x, GetExtendedFileAttributes works with only the DOS name space for remote servers.

See Also

SetExtendedFileAttributes