Syntax

  #include <nwnamspc.h> 
  #include <nwea.h> 
  or 
  #include <nwcalls.h> 
   
  N_EXTERN_LIBRARY(NWCCODE) NWFindNextEA ( 
     NW_EA_FF_STRUCT_EXT  N_FAR  *ffStruct,  
     NW_EA_HANDLE_EXT     N_FAR  *EAHandle,  
     pnstr8                       EAName);
  

Parameters

ffStruct

(IN/OUT) Points to the NW_EA_FF_STRUCT_EXT structure returned by the NWFindFirstEAExt function.

EAHandle

(OUT) Points to the NW_EA_HANDLE_EXT structure.

EAName

(OUT) Points to the name of the Extended Attribute (optional).

Return Values

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

Remarks

Before calling NWFindNextEAExt, you must call the NWFindFirstEAExt function. NWFindNextEAExt can then be called multiple times until all EAs have been found. EA_DONE is returned when there are no more EAs.

With a NW_EA_HANDLE_EXT structure, you can also call the NWReadEAExt and/or NWWriteEA function. Therefore, do not call the NWGetEAHandleStructExt function after the NWFindFirstEAExt function in order initialize a Read or Write.

If you do call the NWGetEAHandleStructExt function in preparation for a Write, use the EAName parameter. When you copy by calling either the NWFindFirstEAExt or NWFindNextEAExt function, the EAName parameter must be used. If the EAName parameter is not needed, pass NULL.

The NW_EA_FF_STRUCT_EXT structure is used by the NWFindFirstEAExt and NWFindNextEAExt functions to return a handle to the first or next Extended Attribute.

NCP Calls

• 0x2222 86 04 Enumerate Extended Attribute
• 0x2222 89 54 Enhanced Enumerate Extended Attribute

See Also

NWFindFirstEAExt, NWGetEAHandleStructExt, NWReadEAExt, NWWriteEAExt