Syntax

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

Parameters

conn

(IN) Specifies the NetWare® server connection handle.

idxStruct

(IN) Points to the NW_IDX structure containing the directory entry index. See NW_IDX in Multiple and Inter-File Services.

ffStruct

(OUT) Points to the NW_EA_FF_STRUCT_EXT structure.

EAHandle

(OUT) Points to the NW_EA_HANDLE_EXT 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, NWFindFirstEAExt returns the NW_EA_HANDLE_EXT structure. If no EAs exist, NWFindFirstEAExt returns 1.

With a NW_EA_HANDLE_EXT structure, you can call the NWReadEAExt and/or NWWriteEAExt function. Therefore, you do not need to call the NWGetEAHandleStructExt function after NWFindFirstEAExt to initialize a Read or Write.

If you do call the NWGetEAHandleStructExt function in preparation for writing, use the EAName parameter. When you copy by calling either NWFindFirstEAExt or the NWFindNextEAExt 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 NWGetDirectoryBaseExt 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.

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

NCP Calls

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

See Also

NWFindNextEAExt, NWGetDirectoryBaseExt (Multiple and Inter-File Management), NWGetEAHandleStructExt, NWReadEAExt, NWWriteEAExt