NWFindFirstEA(3nw)


NWFindFirstEA -- initializes the find-first/find-next Extended Attribute process

Synopsis

   #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);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare® server connection handle.

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

ffStruct
(OUT) Points to NW_EA_FF_STRUCT.

EAHandle
(OUT) Points to NW_EA_HANDLE for the EA.

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

Return values

0x0000
SUCCESSFUL

0x0001
No EAs

0x8801
INVALID_CONNECTION

Notices

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.

Services

Extended Attribute

NCP calls

0x2222 86 04
Enumerate Extended Attribute

References

NWFindNextEA(3nw), NWGetDirectoryBase(3nw), NWGetEAHandleStruct(3nw), NWNSGetMiscInfo(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.