Syntax

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

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. See NW_IDX in 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.

Remarks

The NW_EA_HANDLE_EXT structure is referenced in all Extended Attribute functions. The NWReadEAExt and NWWriteEAExt functions use the NW_EA_HANDLE_EXT 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 NWGetDirectoryBaseExt 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

NWOpenEAExt, NWFindFirstEAExt, NWFindNextEAExt, NWGetDirectoryBaseExt (Multiple and Inter-File Management), NWReadEAExt, NWWriteEAExt