OpenEA

Opens a file or directory for EA I/O

Local Servers:blocking
Remote Servers:blocking
Classification:3.11, 3.12, 3.2, 4.x, 5.x, 6.x
Service:Server-Based Extended Attributes

Syntax

  #include <\nlm\nit\nwextatt.h>  
   
  int OpenEA (  
     const char  *path,  
     LONG         reserved);

Parameters

path
(IN) Path of file or directory whose extended attributes are to be read, written, or scanned.
reserved
(IN) Is reserved; set to zero.

Return Values

This function returns an EA handle if successful. Otherwise, it returns:

EFAILURE

Failure errno and NetWareErrno are set.

Remarks

For cross-platform functionality, call NWOpenEA.

The EA I/O functions that use an EA handle are CloseEA, EnumerateEA, GetEAInfo, ReadEA, and WriteEA.

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

If OpenEA fails, more information is available in NetWareErrno.

NOTE:OpenEA does not work on remote NetWare 3.x servers.

NetWare 3.12 and 4.1

If an incorrect server name is passed, 252 (FCh) is returned. If an incorrect volume name is passed, 152 (98h) is returned. For both of these naming errors, errno and NetWareErrno are both set to zero.

See Also

CloseEA, ReadEA, WriteEA