Syntax

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

Delphi Syntax

  uses calwin32 
   
  Function NWFindNextEA 
    (Var ffStruct : NW_EA_FF_STRUCT; 
     Var EAHandle : NW_EA_HANDLE; 
     EAName : pnstr8 
  ) : NWCCODE;
  

Parameters

ffStruct

(IN/OUT) Points to the NW_EA_FF_STRUCT structure returned by the NWFindFirstEA function.

EAHandle

(OUT) Points to the NW_EA_HANDLE 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 NWFindNextEA, you must call the NWFindFirstEA function. NWFindNextEA can then be called multiple times until all EAs have been found. EA_DONE is returned when there are no more EAs.

The NW_EA_HANDLE structure can also call the NWReadEA and/or NWWriteEA function. Therefore, do not call the NWGetEAHandleStruct function after the NWFindFirstEA function in order initialize a Read or Write.

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

The NW_EA_FF_STRUCT structure is used by the NWFindFirstEA function to return a handle to the first or next Extended Attribute.

The NW_EA_HANDLE and NW_EA_FF_STRUCT structures are for internal use only; do not manipulate these structures in any way.

NCP Calls

• 0x2222 86 04 Enumerate Extended Attribute

See Also

NWFindFirstEA