/***********************************************************************
 *
 *  Copyright (C) 2005-2006 Novell, Inc. All Rights Reserved.
 *
 *  This library is free software; you can redistribute it and/or
 *  modify it under the terms of the GNU Lesser General Public
 *  License as published by the Free Software Foundation; version 2.1
 *  of the License.
 *
 *  This library is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 *  Library Lesser General Public License for more details.
 *
 *  You should have received a copy of the GNU Lesser General Public
 *  License along with this library; if not, Novell, Inc.
 *
 *  To contact Novell about this file by physical or electronic mail,
 *  you may find current contact information at www.novell.com.
 *
 ***********************************************************************/

#if ! defined ( NWEA_H )
#define NWEA_H

#if ! defined ( NTYPES_H )
#include "ntypes.h"
#endif

#if ! defined ( NWCALDEF_H )
#include "nwcaldef.h"
#endif

#if ! defined ( NWNAMSPC_H ) /* Needed top defined NW_IDX */
#include "nwnamspc.h"
#endif

#include "npackon.h"

#ifdef __cplusplus
extern "C" {
#endif

#define EA_EOF                  1
#define EA_DONE                 1

#define EA_READWRITE            0
#define EA_CREATE               1

#define MISSING_EA_KEY             200  /* 0xC8 */
#define EA_NOT_FOUND               201  /* 0xC9 */
#define INVALID_EA_HANDLE_TYPE     202  /* 0xCA */
#define EA_NO_KEY_NO_DATA          203  /* 0xCB */
#define EA_NUMBER_MISMATCH         204  /* 0xCC */
#define EXTENT_NUMBER_OUT_OF_RANGE 205  /* 0xCD */
#define EA_BAD_DIR_NUM             206  /* 0xCE */
#define INVALID_EA_HANDLE          207  /* 0xCF */
#define EA_POSITION_OUT_OF_RANGE   208  /* 0xD0 */
#define EA_ACCESS_DENIED           209  /* 0xD1 */
#define DATA_PAGE_ODD_SIZE         210  /* 0xD2 */
#define EA_VOLUME_NOT_MOUNTED      211  /* 0xD3 */
#define BAD_PAGE_BOUNDARY          212  /* 0xD4 */
#define INSPECT_FAILURE            213  /* 0xD5 */
#define EA_ALREADY_CLAIMED         214  /* 0xD6 */
#define ODD_BUFFER_SIZE            215  /* 0xD7 */
#define NO_SCORECARDS              216  /* 0xD8 */
#define BAD_EDS_SIGNATURE          217  /* 0xD9 */
#define EA_SPACE_LIMIT             218  /* 0xDA */
#define EA_KEY_CORRUPT             219  /* 0xDB */
#define EA_KEY_LIMIT               220  /* 0xDC */
#define TALLY_CORRUPT              221  /* 0xDD */

typedef struct
{
  NWCONN_HANDLE connID;
  nuint32 rwPosition;
  nuint32 EAHandle;
  nuint32 volNumber;
  nuint32 dirBase;
  nuint8  keyUsed;
  nuint16 keyLength;
  nuint8  key[256];
} NW_EA_HANDLE;

typedef struct
{
  NWCONN_HANDLE connID;
  nuint32 rwPosition;
  nuint32 EAHandle;
  nuint32 volNumber;
  nuint32 dirBase;
  nuint8  keyUsed;
  nuint16 keyLength;
  nuint8  key[766];
} NW_EA_HANDLE_EXT;

typedef struct
{
  NWCONN_HANDLE connID;
  nuint16 nextKeyOffset;
  nuint16 nextKey;
  nuint32 numKeysRead;
  nuint32 totalKeys;
  nuint32 EAHandle;
  nuint16 sequence;
  nuint16 numKeysInBuffer;
  nuint8  enumBuffer[512];
} NW_EA_FF_STRUCT;

typedef struct
{
  NWCONN_HANDLE connID;
  nuint16 nextKeyOffset;
  nuint16 nextKey;
  nuint32 numKeysRead;
  nuint32 totalKeys;
  nuint32 EAHandle;
  nuint16 sequence;
  nuint16 numKeysInBuffer;
  nuint8  enumBuffer[1530];
} NW_EA_FF_STRUCT_EXT;


N_EXTERN_LIBRARY( NWCCODE )
NWCloseEA
(
   const NW_EA_HANDLE N_FAR * EAHandle
);

N_EXTERN_LIBRARY( NWCCODE )
NWCloseEAExt
(
   const NW_EA_HANDLE_EXT N_FAR * EAHandle
);

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

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

N_EXTERN_LIBRARY( NWCCODE )
NWFindNextEA
(
   NW_EA_FF_STRUCT N_FAR * ffStruct,
   NW_EA_HANDLE    N_FAR * EAHandle,
   pnstr8                  EAName
);

N_EXTERN_LIBRARY( NWCCODE )
NWFindNextEAExt
(
   NW_EA_FF_STRUCT_EXT N_FAR *  ffStruct,
   NW_EA_HANDLE_EXT N_FAR * EAHandle,
   pnstr8                   EAName
);


N_EXTERN_LIBRARY( NWCCODE )
NWReadEA
(
   NW_EA_HANDLE N_FAR * EAHandle,
   nuint32        bufferSize,
   pnuint8        buffer,
   pnuint32       totalEASize,
   pnuint32       amountRead
);

N_EXTERN_LIBRARY( NWCCODE )
NWReadEAExt
(
   NW_EA_HANDLE_EXT N_FAR * EAHandle,
   nuint32                  bufferSize,
   pnuint8                  buffer,
   pnuint32                 totalEASize,
   pnuint32                 amountRead
);

N_EXTERN_LIBRARY( NWCCODE )
NWWriteEA
(
   NW_EA_HANDLE N_FAR * EAHandle,
   nuint32              totalWriteSize,
   nuint32              bufferSize,
   const nuint8 N_FAR * buffer,
   pnuint32             amountWritten
);

N_EXTERN_LIBRARY( NWCCODE )
NWWriteEAExt
(
   NW_EA_HANDLE_EXT N_FAR * EAHandle,
   nuint32                  totalWriteSize,
   nuint32                  bufferSize,
   const nuint8 N_FAR *     buffer,
   pnuint32                 amountWritten
);

N_EXTERN_LIBRARY( NWCCODE )
NWGetEAHandleStruct
(
   NWCONN_HANDLE        conn,
   const nstr8  N_FAR * EAName,
   const NW_IDX N_FAR * idxStruct,
   NW_EA_HANDLE N_FAR * EAHandle
);

N_EXTERN_LIBRARY( NWCCODE )
NWGetEAHandleStructExt
(
   NWCONN_HANDLE            conn,
   const nstr8  N_FAR *     EAName,
   const NW_IDX N_FAR *     idxStruct,
   NW_EA_HANDLE_EXT N_FAR * EAHandle
);

N_EXTERN_LIBRARY( NWCCODE )
NWOpenEA
(
   NWCONN_HANDLE        conn,
   NWDIR_HANDLE         dirHandle,
   const nstr8  N_FAR * path,
   pnstr8               EAName,
   nuint8               nameSpace,
   NW_EA_HANDLE N_FAR * EAHandle
);

N_EXTERN_LIBRARY( NWCCODE )
NWOpenEAExt
(
   NWCONN_HANDLE            conn,
   NWDIR_HANDLE             dirHandle,
   const nstr8  N_FAR *     path,
   pnstr8                   EAName,
   nuint8                   nameSpace,
   NW_EA_HANDLE_EXT N_FAR * EAHandle
);


#ifdef __cplusplus
}
#endif

#include "npackoff.h"
#endif