NWOpenEA

Fills the NW_EA_HANDLE structure so it can be used by the NWReadEA and NWWriteEA functions

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:Extended Attribute

Syntax

  #include <nwnamspc.h> 
  #include <nwea.h> 
  or 
  #include <nwcalls.h> 
   
  N_EXTERN_LIBRARY(NWCCODE) NWOpenEA ( 
     NWCONN_HANDLE        conn,  
     NWDIR_HANDLE         dirHandle,  
     const nstr8 N_FAR   *path,  
     pnstr8               EAName,  
     nuint8               nameSpace,  
     NW_EA_HANDLE N_FAR  *EAHandle);
  

Delphi Syntax

  uses calwin32 
   
  Function NWOpenEA 
    (conn : NWCONN_HANDLE; 
     dirHandle : NWDIR_HANDLE; 
     const path : pnstr8; 
     EAName : pnstr8; 
     nameSpace : nuint8; 
     Var EAHandle : NW_EA_HANDLE 
  ) : NWCCODE;
  

Parameters

conn
(IN) Specifies the NetWare server connection handle.
dirHandle
(IN) Specifies the NetWare directory handle pointing to the directory to search.
path
(IN) Points to a path.
EAName
(IN) Points to the string containing the name of the Extended Attribute.
nameSpace
(IN) Specifies the name space of the Extended Attribute (see Name Space Flag Values (Multiple and Inter-File Services)).
EAHandle
(IN/OUT) Points to the NW_EA_HANDLE structure containing the handle of the current Extended Attribute.

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

0x8998

VOLUME_DOES_NOT_EXIST

0x899B

BAD_DIRECTORY_HANDLE

0x899C

INVALID_PATH

Remarks

NWOpenEA combines the functionality of the NWGetDirectoryBase and NWGetEAHandleStruct functions in one function.

The NWFindFirstEA and NWFindNextEA functions also return a filled NW_EA_HANDLE structure.

NCP Calls

See Also

NWFindFirstEA, NWFindNextEA, NWGetDirectoryBase (Multiple and Inter-File Management), NWGetEAHandleStruct, NWReadEA, NWWriteEA