NWGetEAHandleStruct(3nw)


NWGetEAHandleStruct -- fills NW_EA_HANDLE

Synopsis

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

NWCCODE N_API NWGetEAHandleStruct (NWCONN_HANDLE conn, pnstr8 EAName, NW_IDX N_FAR * idxStruct, NW_EA_HANDLE N_FAR * EAHandle);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

EAName
(IN) Points to the string containing the name of the EA.

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

EAHandle
(IN/OUT) Points to NW_EA_HANDLE containing the handle of the current EA.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

Notices

NW_EA_HANDLE is referenced in all EA functions. NWReadEA and NWWriteEA use NW_EA_HANDLE to maintain the state information. The state information is required to access the EA database.

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.

Services

Extended Attribute

NCP calls

None

References

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