// Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies).

// All rights reserved.

// This component and the accompanying materials are made available

// which accompanies this distribution, and is available

//

// Initial Contributors:

// Nokia Corporation - initial contribution.

//

// Contributors:

//

// Description:

// Constants for use in storing comms data via CommsDat

// 

//

/**

 @file

 @publishedAll

 @released

*/

#if (!defined COMMSDAT_H)

#define       COMMSDAT_H

#include <comms-infras/metatype.h>

#include <e32property.h>

namespace CommsDat

{

/**

Use this constant for Debug panic calls

@publishedAll

*/

_LIT(KCommsDatName,"CommsDat");

/**

Use this constant for Debug panic calls

@publishedAll

*/

enum

	{

	ECommitBeforeOpenTransaction = 1,

	ERollBackBeforeOpenTransaction = 2,

	ESessionClosed = 3,

	};

using namespace Meta;

// VERSION INFO

//

/**

Versions of the dataset in use

Initial Version 

@publishedAll

*/

#define KCDVersion1_1               TVersion(1,1,1)

#ifdef SYMBIAN_NON_SEAMLESS_NETWORK_BEARER_MOBILITY

/**

Some elements in Version KCDVersion1_1 now deprecated

These elements will be mapped if the client starts a session with KCDVersion1_1

They will be ignored or rejected as not supported if client starts a session with 

@publishedAll

*/

#define KCDVersion1_2               TVersion(1,2,1)

#endif

/**

@publishedAll

*/

#define KCDCurrentVersion           KCDVersion1_1

//  Attribute Flags

//

/**

Access control attribute flags.

When these are SET in the mask the attribute is obeyed

When they are CLEARED from the mask, the attribute is ignored

By default attributes are obeyed.

@publishedAll

*/

typedef enum

{

  ECDNoWriteButDelete = 0x0000010,     // R/W Read Only but deleteable      Caller should explicitly choose to modify

                                       //                                   Enforced by convention only, not with Platform Security

  ECDHidden           = 0x0000020,     // R/W Read-Write Hidden data        Not policed - hides public utility info such as default values

                                       //                                   Enforced by convention only, not with Platform Security  

  ECDPrivate          = 0x0000040,     // R/W Read-Write Private data       For sensitive user data such as passwords

                                       //                                   Policed at storage server API with platsec capability

  ECDProtectedWrite   = 0x0000080,     // W   Write-Protected data          To allow data to be read only to most clients but modifiable by a few privileged clients

                                       //                                   Policed at storage server API with platsec capability

} TCDAttributeFlags;

//

// Masks for Element Type info

//

/**

Mask to use to hide attribute reserved bits

@publishedAll

*/

#define KCDMaskHideAttrAndRes       0xffffff00

/**

Mask to use to show reserved bits

@publishedAll

*/

#define KCDMaskShowRes              0x8000000f

/**

Mask to use to hide reserved bits

@publishedAll

*/

#define KCDMaskHideRes              0x7ffffff0

/**

T x x   Mask to show Table Type info

@publishedAll

*/

#define KCDMaskShowRecordType       0x7f800000

/**

x C x   Mask to show Column Type 

@publishedAll

*/

#define KCDMaskShowFieldType        0x007f0000

/**

T C x   Mask to show Table and Column Type 

@publishedAll

*/

#define KCDMaskShowType             0x7fff0000

/**

T x R   Mask to show Record id

@publishedAll - don't use this.  Replace with KCDMaskShowRecordId

*/

#define KCDMaskShowInstance         0x0000ff00

/**

T x R   Mask to show Record id

Use in place of KCDMaskShowInstance

@publishedAll

*/

#define KCDMaskShowRecordId         0x0000ff00

/**

T C R   Mask to show Field instance without attributes or reserved bits

@publishedAll

*/

#define KCDMaskShowField            0x7fffff00

/**

T x R   Mask to show Record Type and Record Id without column type, attributes or reserved bits

@publishedAll

*/

#define KCDMaskShowRecordTypeAndId  (KCDMaskShowRecordType | KCDMaskShowRecordId)

/**

x C R   Mask to show Column Type and Record Id without Record type, attributes or reserved bits

@publishedAll

*/

#define KCDMaskShowColumnTypeAndRecordId  (KCDMaskShowFieldType |  KCDMaskShowRecordId)

/**

Mask to show Attributes

@publishedAll

*/

#define KCDMaskShowAttributes       0x000000f0

/**

Mask to use to show attributes and reserved bits

@publishedAll

*/

#define KCDMaskShowAttrAndRes       0x000000ff

/**

Id for the Initial record in a record set

@publishedAll

*/

#define KCDInitialRecordId			0x00000100

/**

Id for the Initial table in the database

@publishedAll

*/

#define KCDInitialTableId			0x00800000

/**

Id for the Initial User defined table in the database

clients have 64 table ids available to them

@publishedAll

*/

#define KCDInitialUDefRecordType   0x5F800000

/**

Id for the Last User defined table in the database.

@publishedAll

*/

#define KCDLastUDefRecordType      0x7F800000

/**

Id for the Initial column in a record set

@publishedAll

*/

#define KCDInitialColumnId			0x00010000

/**

T C 0   location for default field values

@publishedAll

*/

#define KCDDefaultRecord            0x00000000

/**

Combine with table id and Column id to give the location of column type info

@publishedAll

@released

*/

/**

Combine with table id to give request for a new record in a table.

The table must already exist.

@publishedAll

*/

#define KCDNewRecordRequest			0x807f0001

/**

Combined with CMDBField, it finds the TableId given the table name

@publishedAll

*/

/**

Maximum number of tables that can be created in one repository

@publishedAll

*/

#define KCDMaxTables                254

/**

Maximum number of User defined tables that can be created in one repository

@publishedAll

*/

#define KCDMaxUserDefTables         64

/**

Maximum number of columns that can be created in one table

@publishedAll

*/

#define KCDMaxColumns               126  

/**

Maximum number of records that can be stored in one table

@publishedAll

*/

#define KCDMaxRecords               254

/**

Maximum number of characters in a field name

@publishedAll

@released

*/

/**

Macro for interaction with netmeta

@publishedAll

*/

#define X_REGISTER_ATTRIBUTE( thisMetaClass, var, metaType ) \

 { _FOFF( thisMetaClass, var ), Meta::metaType##VisitorFactoryL },

#define EXP_DATA_VTABLE \

 IMPORT_C virtual Meta::SVDataTableEntry const* GetVDataTable() const;	\

 IMPORT_C virtual TUint8* GetAttribPtr(const TInt aOffset) const;	\

 IMPORT_C static Meta::SVDataTableEntry const* GetVDataTableStatic(); \

 static const Meta::SVDataTableEntry iVDataTable[];

/**

Macros used to implement virtual functions from MMetaData interface and construct the v data table

@publishedAll

*/

#define EXP_START_ATTRIBUTE_TABLE( thisMetaClass, uid, typeId ) \

 EXPORT_C Meta::SVDataTableEntry const* thisMetaClass::GetVDataTable() const { return &iVDataTable[0]; };	\

 EXPORT_C TUint8* thisMetaClass::GetAttribPtr(const TInt aOffset) const { return (TUint8*)this + aOffset; };	\

 EXPORT_C Meta::SVDataTableEntry const* thisMetaClass::GetVDataTableStatic() { return &iVDataTable[0]; }; \

 const Meta::SVDataTableEntry thisMetaClass::iVDataTable[] = { \

 { uid, reinterpret_cast<Meta::TMetaTypeNewL>(typeId) },

} //end namespace CommsDat

#endif