Syntax

  #include <nwnamspc.h> 
  #include <nwea.h> 
  or 
  #include <nwcalls.h> 
   
  N_EXTERN_LIBRARY(NWCCODE) NWFindFirstEA ( 
     NWCONN_HANDLE            conn,  
     const NW_IDX N_FAR      *idxStruct,  
     NW_EA_FF_STRUCT N_FAR   *ffStruct,  
     NW_EA_HANDLE N_FAR      *EAHandle,  
     pnstr8                   EAName);
  

Delphi Syntax

  uses calwin32 
   
  Function NWFindFirstEA 
    (conn : NWCONN_HANDLE; 
     Var idxStruct : NW_IDX; 
     Var ffStruct : NW_EA_FF_STRUCT; 
     Var EAHandle : NW_EA_HANDLE; 
     EAName : pnstr8 
  ) : NWCCODE;
  

Parameters

conn

(IN) Specifies the NetWare® server connection handle.

idxStruct

(IN) Points to the NW_IDX structure containing the directory entry index.

ffStruct

(OUT) Points to the NW_EA_FF_STRUCT structure.

EAHandle

(OUT) Points to the NW_EA_HANDLE structure for the Extended Attribute.

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

If any EAs exist for the associated file, NWFindFirstEA returns the NW_EA_HANDLE structure. If no EAs exist, NWFindFirstEA returns 1.

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

If you do call the NWGetEAHandleStruct function in preparation for writing, use the EAName parameter. When you copy by calling either NWFindFirstEA or the NWFindNextEA function, you must use the EAName parameter. If the EAName parameter is not needed, it can be passed NULL.

Information for the NW_IDX structure is obtained by calling the NWNSGetMiscInfo or NWGetDirectoryBase function. Functions use the NW_IDX structure to hold information concerning the name space and directory entry index of a file. This is how an application associates an Extended Attribute with a particular directory entry.

NWFindFirstEA will return INVALID_PARAMETER if NULL is passed to either the ffStruct or EAHandle parameters.

NCP Calls

• 0x2222 86 04 Enumerate Extended Attribute

See Also

NWFindNextEA, NWGetDirectoryBase (Multiple and Inter-File Management), NWGetEAHandleStruct, NWReadEA, NWWriteEA