CCommsDatabase Class Reference

class CCommsDatabase : public CCommsDatabaseBase

Accesses the communications database through the DBMS.

An object of this type must be constructed and opened by a client before any of the tables in the database can be accessed, e.g. to create views and access template records.

Implements the pure virtual functions CreateDatabaseL() and DoOpen(). Responsible for Global settings and Connection Preferences. Has utility functions for accessing Global and Agent tables. No additional state (to CCommsDatabaseBase) is stored.

Inherits from

Public Member Functions
~CCommsDatabase()
IMPORT_C voidClearAgentAndExtL(const TDesC &)
IMPORT_C voidClearGlobalSettingL(const TDesC &)
IMPORT_C TIntGetAgentClientTimeoutL(const TDesC &)
IMPORT_C voidGetAgentExtL(const TDesC &, TDes &)
IMPORT_C voidGetAgentL(const TDesC &, TDes &)
IMPORT_C TIntGetAgentRouteTimeoutL(const TDesC &)
IMPORT_C voidGetCurrentDialInSettingL(const TDesC &, TUint32 &)
IMPORT_C voidGetCurrentDialOutSettingL(const TDesC &, TUint32 &)
IMPORT_C voidGetDefaultTsyL(TDes &)
IMPORT_C voidGetGlobalSettingL(const TDesC &, TUint32 &)
IMPORT_C voidGetGlobalSettingL(const TDesC &, TDes &)
IMPORT_C CCommsDatabase *NewL()
IMPORT_C CCommsDatabase *NewL(TBool)
IMPORT_C CCommsDatabase *NewL(TCommDbOpeningMethod &)
IMPORT_C CCommsDatabase *NewL(TCommDbDatabaseType)
IMPORT_C CCommsDatabase *NewL(TCommDbDatabaseType, TCommDbOpeningMethod &)
IMPORT_C CCommsDbConnectionPrefTableView *OpenConnectionPrefTableInRankOrderLC(TCommDbConnectionDirection)
IMPORT_C CCommsDbConnectionPrefTableView *OpenConnectionPrefTableLC()
IMPORT_C CCommsDbConnectionPrefTableView *OpenConnectionPrefTableLC(TCommDbConnectionDirection)
IMPORT_C CCommsDbConnectionPrefTableView *OpenConnectionPrefTableViewOnRankLC(TCommDbConnectionDirection, TUint32)
IMPORT_C CCommsDbTableView *OpenIAPTableViewMatchingBearerSetLC(TUint32, TCommDbConnectionDirection)
IMPORT_C CCommsDbTableView *OpenIAPTableViewMatchingNetworkLC(TUint32)
IMPORT_C CCommsDbTableView *OpenViewOnProxyRecordLC(TUint32, const TDesC &)
IMPORT_C voidSetAgentClientTimeoutL(const TDesC &, TInt)
IMPORT_C voidSetAgentExtL(const TDesC &, const TDesC &)
IMPORT_C voidSetAgentL(const TDesC &, const TDesC &)
IMPORT_C voidSetAgentRouteTimeoutL(const TDesC &, TInt)
IMPORT_C voidSetGlobalSettingL(const TDesC &, TUint32)
IMPORT_C voidSetGlobalSettingL(const TDesC &, const TDesC &)
Protected Member Functions
CCommsDatabase()
voidDoOpenL(TCommDbOpeningMethod &, TBool)
Private Member Functions
voidCreateDatabaseL()
TGlobalSettingType GlobalSettingTypeL(const TDesC &)
CCommsDbTableView *OpenGlobalSettingsTableLC(const TDesC &, TBool &)
Inherited Functions
CBase::CBase()
CBase::Delete(CBase *)
CBase::Extension_(TUint,TAny *&,TAny *)
CBase::operator new(TUint)
CBase::operator new(TUint,TAny *)
CBase::operator new(TUint,TLeave)
CBase::operator new(TUint,TLeave,TUint)
CBase::operator new(TUint,TUint)
CBase::~CBase()
CCommsDatabaseBase::BeginInternalTransactionL()
CCommsDatabaseBase::BeginTransaction()
CCommsDatabaseBase::CCommsDatabaseBase()
CCommsDatabaseBase::CancelRequestNotification()
CCommsDatabaseBase::CheckDBCapability(RDbs::TPolicyType,const TDesC &,const RMessagePtr2 *)
CCommsDatabaseBase::CheckReadCapability(const TDesC &,const RMessagePtr2 *)
CCommsDatabaseBase::CheckWriteCapability(const TDesC &,const RMessagePtr2 *)
CCommsDatabaseBase::CommitInternalTransaction()
CCommsDatabaseBase::CommitTransaction()
CCommsDatabaseBase::ConvertToUid(const TDesC &,TUint32,TCommDbPublishSubscribeNotification &)
CCommsDatabaseBase::Database()
CCommsDatabaseBase::DatabaseUpdateHasOccurred()
CCommsDatabaseBase::DoClose()
CCommsDatabaseBase::DoOpenIAPTableViewL(const TDesC &,const TDesC &)
CCommsDatabaseBase::DoOpenTableViewL(const TDesC &,const TDesC &)
CCommsDatabaseBase::DoOpenViewMatchingTextL(const TDesC &,const TDesC &,const TDesC16 &,TBool)
CCommsDatabaseBase::DoOpenViewMatchingTextL(const TDesC &,const TDesC &,const TDesC8 &,TBool)
CCommsDatabaseBase::DoOpenViewMatchingUintL(const TDesC &,const TDesC &,TUint32,TBool)
CCommsDatabaseBase::GetNewNumber(TUid)
CCommsDatabaseBase::InTransaction()
CCommsDatabaseBase::InitializeFilestore()
CCommsDatabaseBase::IsDatabaseWriteLockedL()
CCommsDatabaseBase::NotifyAllChanges()
CCommsDatabaseBase::NotifyChangeL(const TDesC &,TUint32)
CCommsDatabaseBase::OpenTableLC(const TDesC &)
CCommsDatabaseBase::OpenViewLC(const TDesC &,const TDesC &)
CCommsDatabaseBase::OpenViewMatchingBoolLC(const TDesC &,const TDesC &,TBool)
CCommsDatabaseBase::OpenViewMatchingTextLC(const TDesC &,const TDesC &,const TDesC16 &)
CCommsDatabaseBase::OpenViewMatchingTextLC(const TDesC &,const TDesC &,const TDesC8 &)
CCommsDatabaseBase::OpenViewMatchingUintLC(const TDesC &,const TDesC &,TUint32)
CCommsDatabaseBase::PopulateChargeCardL(TUint32,TChargeCard &)
CCommsDatabaseBase::PopulateDialLocationL(TUint32,TDialLocation &)
CCommsDatabaseBase::RequestNotification(TRequestStatus &)
CCommsDatabaseBase::ResolvePhoneNumberFromDatabaseL(TDesC &,TDes &,TParseMode,TUint32,TUint32)
CCommsDatabaseBase::ResolvePhoneNumberL(TDesC &,TDes &,TParseMode,TUint32,TUint32)
CCommsDatabaseBase::RollbackInternalTransaction()
CCommsDatabaseBase::RollbackTransaction()
CCommsDatabaseBase::ShowHiddenRecords()
CCommsDatabaseBase::Version()const
CCommsDatabaseBase::~CCommsDatabaseBase()
Private Member Enumerations
enumTGlobalSettingType { ENotASetting, EGlobalSetting, ECompatibilitySetting }
Inherited Attributes
CCommsDatabaseBase::iDatabase
CCommsDatabaseBase::iImpl
CCommsDatabaseBase::iImplNotCreated
CCommsDatabaseBase::iInInternalTransaction
CCommsDatabaseBase::iNotifications
CCommsDatabaseBase::iNotifier
CCommsDatabaseBase::iNotifierOpenError
CCommsDatabaseBase::iShowHiddenRecords

Constructor & Destructor Documentation

CCommsDatabase()

CCommsDatabase()[protected]

~CCommsDatabase()

IMPORT_C~CCommsDatabase()[virtual]

Member Functions Documentation

ClearAgentAndExtL(const TDesC &)

IMPORT_C voidClearAgentAndExtL(const TDesC &aService)

Parameters

const TDesC & aService

ClearGlobalSettingL(const TDesC &)

IMPORT_C voidClearGlobalSettingL(const TDesC &aSetting)

Parameters

const TDesC & aSetting

CreateDatabaseL()

voidCreateDatabaseL()[private, virtual]

CCommsDatabaseBase pure virtuals

DoOpenL(TCommDbOpeningMethod &, TBool)

voidDoOpenL(TCommDbOpeningMethod &aOpeningMethod,
TBoolaUseDefaultDb
)[protected]

Parameters

TCommDbOpeningMethod & aOpeningMethod
TBool aUseDefaultDb

GetAgentClientTimeoutL(const TDesC &)

IMPORT_C TIntGetAgentClientTimeoutL(const TDesC &aService)

Parameters

const TDesC & aService

GetAgentExtL(const TDesC &, TDes &)

IMPORT_C voidGetAgentExtL(const TDesC &aService,
TDes &aAgentExt
)

Parameters

const TDesC & aService
TDes & aAgentExt

GetAgentL(const TDesC &, TDes &)

IMPORT_C voidGetAgentL(const TDesC &aService,
TDes &aAgent
)

Parameters

const TDesC & aService
TDes & aAgent

GetAgentRouteTimeoutL(const TDesC &)

IMPORT_C TIntGetAgentRouteTimeoutL(const TDesC &aService)

Parameters

const TDesC & aService

GetCurrentDialInSettingL(const TDesC &, TUint32 &)

IMPORT_C voidGetCurrentDialInSettingL(const TDesC &aSetting,
TUint32 &aValue
)

Parameters

const TDesC & aSetting
TUint32 & aValue

GetCurrentDialOutSettingL(const TDesC &, TUint32 &)

IMPORT_C voidGetCurrentDialOutSettingL(const TDesC &aSetting,
TUint32 &aValue
)

Parameters

const TDesC & aSetting
TUint32 & aValue

GetDefaultTsyL(TDes &)

IMPORT_C voidGetDefaultTsyL(TDes &aValue)

Parameters

TDes & aValue

GetGlobalSettingL(const TDesC &, TUint32 &)

IMPORT_C voidGetGlobalSettingL(const TDesC &aSetting,
TUint32 &aValue
)

Parameters

const TDesC & aSetting
TUint32 & aValue

GetGlobalSettingL(const TDesC &, TDes &)

IMPORT_C voidGetGlobalSettingL(const TDesC &aSetting,
TDes &aValue
)

Parameters

const TDesC & aSetting
TDes & aValue

GlobalSettingTypeL(const TDesC &)

TGlobalSettingType GlobalSettingTypeL(const TDesC &aSetting)const [private]

Parameters

const TDesC & aSetting

NewL()

IMPORT_C CCommsDatabase *NewL()[static]

NewL(TBool)

IMPORT_C CCommsDatabase *NewL(TBoolaUseDefaultDb)[static]

Parameters

TBool aUseDefaultDb

NewL(TCommDbOpeningMethod &)

IMPORT_C CCommsDatabase *NewL(TCommDbOpeningMethod &aOpeningMethod)[static]

Parameters

TCommDbOpeningMethod & aOpeningMethod

NewL(TCommDbDatabaseType)

IMPORT_C CCommsDatabase *NewL(TCommDbDatabaseTypeaDbType)[static]

Parameters

TCommDbDatabaseType aDbType

NewL(TCommDbDatabaseType, TCommDbOpeningMethod &)

IMPORT_C CCommsDatabase *NewL(TCommDbDatabaseTypeaDbType,
TCommDbOpeningMethod &aOpeningMethod
)[static]

Parameters

TCommDbDatabaseType aDbType
TCommDbOpeningMethod & aOpeningMethod

OpenConnectionPrefTableInRankOrderLC(TCommDbConnectionDirection)

IMPORT_C CCommsDbConnectionPrefTableView *OpenConnectionPrefTableInRankOrderLC(TCommDbConnectionDirectionaDirection)

Parameters

TCommDbConnectionDirection aDirection

OpenConnectionPrefTableLC()

IMPORT_C CCommsDbConnectionPrefTableView *OpenConnectionPrefTableLC()

OpenConnectionPrefTableLC(TCommDbConnectionDirection)

IMPORT_C CCommsDbConnectionPrefTableView *OpenConnectionPrefTableLC(TCommDbConnectionDirectionaDirection)

Parameters

TCommDbConnectionDirection aDirection

OpenConnectionPrefTableViewOnRankLC(TCommDbConnectionDirection, TUint32)

IMPORT_C CCommsDbConnectionPrefTableView *OpenConnectionPrefTableViewOnRankLC(TCommDbConnectionDirectionaDirection,
TUint32aRank
)

Parameters

TCommDbConnectionDirection aDirection
TUint32 aRank

OpenGlobalSettingsTableLC(const TDesC &, TBool &)

CCommsDbTableView *OpenGlobalSettingsTableLC(const TDesC &aSetting,
TBool &aExists
)[private]

Parameters

const TDesC & aSetting
TBool & aExists

OpenIAPTableViewMatchingBearerSetLC(TUint32, TCommDbConnectionDirection)

IMPORT_C CCommsDbTableView *OpenIAPTableViewMatchingBearerSetLC(TUint32aBearerSet,
TCommDbConnectionDirectionaDirection
)

Open a view on the IAP table containing records that match the bearers and direction specified. `aBearerSet` is a bit mask of type `TCommDbBearer`.

Parameters

TUint32 aBearerSet
TCommDbConnectionDirection aDirection

OpenIAPTableViewMatchingNetworkLC(TUint32)

IMPORT_C CCommsDbTableView *OpenIAPTableViewMatchingNetworkLC(TUint32aNetwork)

Open a viewon the IAP table containing records which match the specified network

Parameters

TUint32 aNetwork

OpenViewOnProxyRecordLC(TUint32, const TDesC &)

IMPORT_C CCommsDbTableView *OpenViewOnProxyRecordLC(TUint32aServiceId,
const TDesC &aServiceType
)

Parameters

TUint32 aServiceId
const TDesC & aServiceType

SetAgentClientTimeoutL(const TDesC &, TInt)

IMPORT_C voidSetAgentClientTimeoutL(const TDesC &aService,
TIntaClientTimeout
)

Parameters

const TDesC & aService
TInt aClientTimeout

SetAgentExtL(const TDesC &, const TDesC &)

IMPORT_C voidSetAgentExtL(const TDesC &aService,
const TDesC &aAgentExt
)

Parameters

const TDesC & aService
const TDesC & aAgentExt

SetAgentL(const TDesC &, const TDesC &)

IMPORT_C voidSetAgentL(const TDesC &aService,
const TDesC &aAgent
)

Parameters

const TDesC & aService
const TDesC & aAgent

SetAgentRouteTimeoutL(const TDesC &, TInt)

IMPORT_C voidSetAgentRouteTimeoutL(const TDesC &aService,
TIntaRouteTimeout
)

Parameters

const TDesC & aService
TInt aRouteTimeout

SetGlobalSettingL(const TDesC &, TUint32)

IMPORT_C voidSetGlobalSettingL(const TDesC &aSetting,
TUint32aValue
)

Parameters

const TDesC & aSetting
TUint32 aValue

SetGlobalSettingL(const TDesC &, const TDesC &)

IMPORT_C voidSetGlobalSettingL(const TDesC &aSetting,
const TDesC &aValue
)

Parameters

const TDesC & aSetting
const TDesC & aValue

Member Enumerations Documentation

Enum TGlobalSettingType

Enumerators

ENotASetting
EGlobalSetting
ECompatibilitySetting
© Nokia 2010.