#include <nwnamspc.h> #include <nwea.h> or #include <nwcalls.h>NWCCODE N_API NWFindFirstEA (NWCONN_HANDLE conn, NW_IDX N_FAR
idxStruct, NW_EA_FF_STRUCT N_FAR
ffStruct, NW_EA_HANDLE N_FAR
EAHandle, pnstr8 EAName);
If any EAs exist for the associated file, NWFindFirstEA returns NW_EA_HANDLE. If no EAs exist, NWFindFirstEA returns a 1.
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 to 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_IDX information is obtained by calling NWNSGetMiscInfo or NWGetDirectoryBase. APIs use NW_IDX to hold information concerning the name space and directory entry index of a file. This is how an application associates an EA with a particular directory entry.
NW_EA_FF_STRUCT is used internally by NWFindFirstEA.
NW_EA_HANDLE and NW_EA_FF_STRUCT are for internal use only; applications must not manipulate these structures in any way.
Extended Attribute