NWFindNextEA(3nw)


NWFindNextEA -- returns NW_EA_HANDLE

Synopsis

   #include <nwnamspc.h> 
   #include <nwea.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWFindNextEA (NW_EA_FF_STRUCT N_FAR * ffStruct, NW_EA_HANDLE N_FAR * EAHandle, pnstr8 EAName);

Description

The parameters are as follows:

ffStruct
(IN/OUT) Points to NW_EA_FF_STRUCT returned by NWFindFirstEA.

EAHandle
(OUT) Points to NW_EA_HANDLE.

EAName
(OUT) Points to the name of the EA (optional).

Return values

0x0000
SUCCESSFUL

0x0001
EA_DONE

Notices

Before calling NWFindNextEA, the application must call NWFindFirstEA. NWFindNextEA can then be called multiple times until all EAs have been found. EA_DONE is returned when there are no more EAs.

An application can also use NW_EA_HANDLE to call NWReadEA and/or NWWriteEA. Therefore, an application does not need to call NWGetEAHandleStruct after NWFindFirstEA in order initialize a Read or Write.

If an application does call NWGetEAHandleStruct in preparation for a Write, EAName needs to be used. When an application copies by calling either NWFindFirstEA or NWFindNextEA, the application requires EAName. If EAName is not needed, it can be set to NULL.

NW_EA_FF_STRUCT is used by NWFindFirstEA to return a handle to the first or next EA.

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

Services

Extended Attribute

NCP calls

0x2222 86 04
Enumerate Extended Attribute

References

NWFindFirstEA(3nw)


30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.