Syntax

  #include <nwnamspc.h> 
  #include <nwea.h> 
  or 
  #include <nwcalls.h> 
   
  N_EXTERN_LIBRARY(NWCCODE) NWGetEAHandleStruct ( 
     NWCONN_HANDLE         conn,  
     const nstr8 N_FAR    *EAName,  
     const NW_IDX N_FAR   *idxStruct,  
     NW_EA_HANDLE N_FAR   *EAHandle);
  

Delphi Syntax

  uses calwin32 
   
  Function NWGetEAHandleStruct 
    (conn : NWCONN_HANDLE; 
     const EAName : pnstr8; 
     const idxStruct : pNW_IDX; 
     Var EAHandle : NW_EA_HANDLE 
  ) : NWCCODE;
  

Parameters

conn

(IN) Specifies the NetWare server connection handle.

EAName

(IN) Points to the string containing the name of the Extended Attribute.

idxStruct

(IN) Points to the NW_IDX structure containing the directory entry index.

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.

Remarks

The NW_EA_HANDLE structure is referenced in all Extended Attribute functions. The NWReadEA and NWWriteEA functions use the NW_EA_HANDLE structure to maintain state information. The state information is required to access the Extended Attribute database.

The NW_IDX structure information is obtained by calling the NWNSGetMiscInfo or NWGetDirectoryBase function. Functions use the NW_IDX structure to hold information about the name space and directory entry index of a file. This is how an application associates an Extended Attribute with a particular directory entry.

See Also

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