NWGetExtendedFileAttributes2

Returns the NetWare extended file attributes for the specified file

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 3.2, 4.x, 5.x, 6.x
Platform:NLM, 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) NWGetExtendedFileAttributes2 ( 
      NWCONN_HANDLE       conn,  
      NWDIR_HANDLE        dirHandle,  
      const nstr8 N_FAR  *path,  
      pnuint8             extAttrs);
   

Delphi Syntax

   uses calwin32 
    
   Function NWGetExtendedFileAttributes2 
     (conn : NWCONN_HANDLE; 
      dirHandle : NWDIR_HANDLE; 
      const path : pnstr8; 
      extAttrs : pnuint8 
   ) : NWCCODE;
   

Parameters

conn

(IN) Specifies the NetWare server connection handle.

dirHandle

(IN) Specifies the directory handle of the new root directory.

path

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

extAttrs

(OUT) Points to the extended attributes of the file.

Return Values

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

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_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

Remarks

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

The path parameter can specify the 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 path parameter could be the following:

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

The information accessed by the extAttrs parameter is interpreted as follows:

0-2

Search mode bits

4

Transaction bit

5

Index bit

6

Read audit bit

7

Write audit bit

NCP Calls

See Also

NWSetExtendedFileAttributes2