Symbian^3 Application Developer Library >

CCommsDbAccess Class Reference

class CCommsDbAccess : public CBase

CCommsDbAccess One of these per CAgentController object. Has a CCommsDatabase object and CCommsDbTableView's for accessing data in CommDb. Also uses a CCommDbOverrideSettings for accessing overridden fields. Also has a CDbChangeNotification for checking when the database is changed. Exported methods in CCommsDbAccess object are also used by the CScriptBase class.

Inherits from

Nested Classes and Structures

Public Member Functions
~CCommsDbAccess ()
IMPORT_C void CancelRequestNotificationOfServiceChange ( MServiceChangeObserver *)
IMPORT_C TInt CheckReadCapability (const TDesC &, const RMessagePtr2 *)
IMPORT_C TInt CheckWriteCapability (const TDesC &, const RMessagePtr2 *)
IMPORT_C void Close ()
IMPORT_C TBool DoesIapExistL ( TUint32 )
void GetAgentExtL (const TDesC &, TDes &)
void GetAuthParamsL ( TBool &, TDes &, TDes &)
IMPORT_C void GetBearerAvailabilityTsyNameL ( TDes &)
IMPORT_C void GetBoolL (const TDesC &, const TDesC &, TBool &)
IMPORT_C TInt GetConnectionAttempts ()
IMPORT_C TCommDbConnectionDirection GetConnectionDirection ()
IMPORT_C void GetCurrentSettingsL ( TConnectionSettings &, TCommDbConnectionDirection , TUint32 )
IMPORT_C void GetDesL (const TDesC &, const TDesC &, TDes8 &)
IMPORT_C void GetDesL (const TDesC &, const TDesC &, TDes16 &)
IMPORT_C void GetFirstValidIapL ( TUint32 &)
IMPORT_C void GetGlobalL (const TDesC &, TUint32 &)
IMPORT_C void GetIntL (const TDesC &, const TDesC &, TUint32 &)
IMPORT_C TInt GetLengthOfLongDesL (const TDesC &, const TDesC &)
IMPORT_C HBufC * GetLongDesLC (const TDesC &, const TDesC &)
IMPORT_C void GetPreferedIapL ( TUint32 &, TCommDbConnectionDirection , TUint32 )
IMPORT_C void GetServiceSettingsL ( TConnectionSettings &)
IMPORT_C void GetServiceTypeL ( TDes &)
IMPORT_C void GetTsyNameL ( TDes &)
IMPORT_C TBool IsShowingHiddenRecords ()
IMPORT_C TBool IsTelNumLengthZeroForRasConnectionL ( TConnectionSettings &)
IMPORT_C TUint32 LocationId ()
IMPORT_C CCommsDbAccessModemTable * ModemTable ()
IMPORT_C RMobilePhone::TMobilePhoneNetworkMode NetworkMode ()
IMPORT_C CCommsDbAccess * NewL ()
IMPORT_C CCommsDbAccess * NewL ( TBool )
IMPORT_C CCommsDbAccess * NewL (MCommsDbAccess *)
IMPORT_C TInt ReadBool (const TDesC &, TBool &)
IMPORT_C TInt ReadDes (const TDesC &, TDes8 &)
IMPORT_C TInt ReadDes (const TDesC &, TDes16 &)
IMPORT_C TInt ReadInt (const TDesC &, TUint32 &)
IMPORT_C HBufC * ReadLongDesLC (const TDesC &)
IMPORT_C void RequestNotificationOfServiceChangeL ( MServiceChangeObserver *)
IMPORT_C void SetCommPortL (const RCall::TCommPort &)
IMPORT_C void SetCurrentSettingsL (const TConnectionSettings &)
IMPORT_C void SetModemAndLocationL (const TConnectionSettings &)
IMPORT_C void SetNetworkMode (const RMobilePhone::TMobilePhoneNetworkMode )
IMPORT_C void SetOverridesL ( CCommDbOverrideSettings *)
IMPORT_C void SetPreferedIapL ( TUint32 &, TCommDbConnectionDirection , TUint32 )
IMPORT_C TInt WriteBool (const TDesC &, TBool )
IMPORT_C TInt WriteDes (const TDesC &, const TDesC8 &)
IMPORT_C TInt WriteDes (const TDesC &, const TDesC16 &)
IMPORT_C TInt WriteInt (const TDesC &, TUint32 )
Private Member Functions
CCommsDbAccess ()
CCommsDbAccess (MCommsDbAccess *)
void ConstructL ( TBool )
MCommsDbAccess * GetImpl ()
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()
Private Attributes
TBool iOwnImpl
MCommsDbAccess * iPimpl

Constructor & Destructor Documentation

CCommsDbAccess()

CCommsDbAccess ( ) [private]

CCommsDbAccess(MCommsDbAccess *)

CCommsDbAccess ( MCommsDbAccess * aPimpl ) [private, explicit]

Parameters

MCommsDbAccess * aPimpl

~CCommsDbAccess()

IMPORT_C ~CCommsDbAccess ( )

Member Functions Documentation

CancelRequestNotificationOfServiceChange(MServiceChangeObserver *)

IMPORT_C void CancelRequestNotificationOfServiceChange ( MServiceChangeObserver * aObserver )

Parameters

MServiceChangeObserver * aObserver

CheckReadCapability(const TDesC &, const RMessagePtr2 *)

IMPORT_C TInt CheckReadCapability ( const TDesC & aField,
const RMessagePtr2 * aMessage
)

Data capability checking

Parameters

const TDesC & aField
const RMessagePtr2 * aMessage

CheckWriteCapability(const TDesC &, const RMessagePtr2 *)

IMPORT_C TInt CheckWriteCapability ( const TDesC & aField,
const RMessagePtr2 * aMessage
)

Parameters

const TDesC & aField
const RMessagePtr2 * aMessage

Close()

IMPORT_C void Close ( )

Close database access

ConstructL(TBool)

void ConstructL ( TBool aShowHidden ) [private]

Parameters

TBool aShowHidden

DoesIapExistL(TUint32)

IMPORT_C TBool DoesIapExistL ( TUint32 aIapId )

Parameters

TUint32 aIapId

GetAgentExtL(const TDesC &, TDes &)

void GetAgentExtL ( const TDesC & aServiceType,
TDes & aAgentExt
)

Agent Related

Parameters

const TDesC & aServiceType
TDes & aAgentExt

GetAuthParamsL(TBool &, TDes &, TDes &)

void GetAuthParamsL ( TBool & aPromptForAuth,
TDes & aUsername,
TDes & aPassword
)

Parameters

TBool & aPromptForAuth
TDes & aUsername
TDes & aPassword

GetBearerAvailabilityTsyNameL(TDes &)

IMPORT_C void GetBearerAvailabilityTsyNameL ( TDes & aTsyName )

Modem related

Parameters

TDes & aTsyName

GetBoolL(const TDesC &, const TDesC &, TBool &)

IMPORT_C void GetBoolL ( const TDesC & aTable,
const TDesC & aField,
TBool & aValue
)

Parameters

const TDesC & aTable
const TDesC & aField
TBool & aValue

GetConnectionAttempts()

IMPORT_C TInt GetConnectionAttempts ( )

GetConnectionDirection()

IMPORT_C TCommDbConnectionDirection GetConnectionDirection ( ) const

GetCurrentSettingsL(TConnectionSettings &, TCommDbConnectionDirection, TUint32)

IMPORT_C void GetCurrentSettingsL ( TConnectionSettings & aSettings,
TCommDbConnectionDirection aDirection,
TUint32 aRank
)

Default setting

Parameters

TConnectionSettings & aSettings
TCommDbConnectionDirection aDirection
TUint32 aRank

GetDesL(const TDesC &, const TDesC &, TDes8 &)

IMPORT_C void GetDesL ( const TDesC & aTable,
const TDesC & aField,
TDes8 & aValue
)

Parameters

const TDesC & aTable
const TDesC & aField
TDes8 & aValue

GetDesL(const TDesC &, const TDesC &, TDes16 &)

IMPORT_C void GetDesL ( const TDesC & aTable,
const TDesC & aField,
TDes16 & aValue
)

Parameters

const TDesC & aTable
const TDesC & aField
TDes16 & aValue

GetFirstValidIapL(TUint32 &)

IMPORT_C void GetFirstValidIapL ( TUint32 & aIapId )

Parameters

TUint32 & aIapId

GetGlobalL(const TDesC &, TUint32 &)

IMPORT_C void GetGlobalL ( const TDesC & aName,
TUint32 & aVal
)

Parameters

const TDesC & aName
TUint32 & aVal

GetImpl()

MCommsDbAccess * GetImpl ( ) const [private]

GetIntL(const TDesC &, const TDesC &, TUint32 &)

IMPORT_C void GetIntL ( const TDesC & aTable,
const TDesC & aField,
TUint32 & aValue
)

Reads from the agent extensions: read from the overrides, or if they don't exist straight from the database

Parameters

const TDesC & aTable
const TDesC & aField
TUint32 & aValue

GetLengthOfLongDesL(const TDesC &, const TDesC &)

IMPORT_C TInt GetLengthOfLongDesL ( const TDesC & aTable,
const TDesC & aField
)

Parameters

const TDesC & aTable
const TDesC & aField

GetLongDesLC(const TDesC &, const TDesC &)

IMPORT_C HBufC * GetLongDesLC ( const TDesC & aTable,
const TDesC & aField
)

Parameters

const TDesC & aTable
const TDesC & aField

GetPreferedIapL(TUint32 &, TCommDbConnectionDirection, TUint32)

IMPORT_C void GetPreferedIapL ( TUint32 & aIapId,
TCommDbConnectionDirection aDirection,
TUint32 aRank
)

Parameters

TUint32 & aIapId
TCommDbConnectionDirection aDirection
TUint32 aRank

GetServiceSettingsL(TConnectionSettings &)

IMPORT_C void GetServiceSettingsL ( TConnectionSettings & aSettings )

Parameters

TConnectionSettings & aSettings

GetServiceTypeL(TDes &)

IMPORT_C void GetServiceTypeL ( TDes & aServiceType )

Service Related

Parameters

TDes & aServiceType

GetTsyNameL(TDes &)

IMPORT_C void GetTsyNameL ( TDes & aTsyName )

Parameters

TDes & aTsyName

IsShowingHiddenRecords()

IMPORT_C TBool IsShowingHiddenRecords ( )

IsTelNumLengthZeroForRasConnectionL(TConnectionSettings &)

IMPORT_C TBool IsTelNumLengthZeroForRasConnectionL ( TConnectionSettings & aSettings )

Parameters

TConnectionSettings & aSettings

LocationId()

IMPORT_C TUint32 LocationId ( ) const

ModemTable()

IMPORT_C CCommsDbAccessModemTable * ModemTable ( )

The caller of this function takes ownership of the object returned and is responsible for deleting it. However the caller is not responsible for deleting the referenced record and session.

NetworkMode()

IMPORT_C RMobilePhone::TMobilePhoneNetworkMode NetworkMode ( ) const

NewL()

IMPORT_C CCommsDbAccess * NewL ( ) [static]

NewL(TBool)

IMPORT_C CCommsDbAccess * NewL ( TBool aShowHidden ) [static]

Parameters

TBool aShowHidden

NewL(MCommsDbAccess *)

IMPORT_C CCommsDbAccess * NewL ( MCommsDbAccess * aPimpl ) [static]

Parameters

MCommsDbAccess * aPimpl

ReadBool(const TDesC &, TBool &)

IMPORT_C TInt ReadBool ( const TDesC & aField,
TBool & aValue
)

Parameters

const TDesC & aField
TBool & aValue

ReadDes(const TDesC &, TDes8 &)

IMPORT_C TInt ReadDes ( const TDesC & aField,
TDes8 & aValue
)

Parameters

const TDesC & aField
TDes8 & aValue

ReadDes(const TDesC &, TDes16 &)

IMPORT_C TInt ReadDes ( const TDesC & aField,
TDes16 & aValue
)

Parameters

const TDesC & aField
TDes16 & aValue

ReadInt(const TDesC &, TUint32 &)

IMPORT_C TInt ReadInt ( const TDesC & aField,
TUint32 & aValue
)

Call to database server for use by NifMan

Parameters

const TDesC & aField
TUint32 & aValue

ReadLongDesLC(const TDesC &)

IMPORT_C HBufC * ReadLongDesLC ( const TDesC & aField )

Parameters

const TDesC & aField

RequestNotificationOfServiceChangeL(MServiceChangeObserver *)

IMPORT_C void RequestNotificationOfServiceChangeL ( MServiceChangeObserver * aObserver )

Service change noification

Parameters

MServiceChangeObserver * aObserver

SetCommPortL(const RCall::TCommPort &)

IMPORT_C void SetCommPortL ( const RCall::TCommPort & aCommPort )

Parameters

const RCall::TCommPort & aCommPort

SetCurrentSettingsL(const TConnectionSettings &)

IMPORT_C void SetCurrentSettingsL ( const TConnectionSettings & aSettings )

Parameters

const TConnectionSettings & aSettings

SetModemAndLocationL(const TConnectionSettings &)

IMPORT_C void SetModemAndLocationL ( const TConnectionSettings & aSettings )

Parameters

const TConnectionSettings & aSettings

SetNetworkMode(const RMobilePhone::TMobilePhoneNetworkMode)

IMPORT_C void SetNetworkMode ( const RMobilePhone::TMobilePhoneNetworkMode aNetworkMode )

MobileIP Related

Parameters

const RMobilePhone::TMobilePhoneNetworkMode aNetworkMode

SetOverridesL(CCommDbOverrideSettings *)

IMPORT_C void SetOverridesL ( CCommDbOverrideSettings * aOverrides )

Set function

Parameters

CCommDbOverrideSettings * aOverrides

SetPreferedIapL(TUint32 &, TCommDbConnectionDirection, TUint32)

IMPORT_C void SetPreferedIapL ( TUint32 & aIapId,
TCommDbConnectionDirection aDirection,
TUint32 aRank
)

Parameters

TUint32 & aIapId
TCommDbConnectionDirection aDirection
TUint32 aRank

WriteBool(const TDesC &, TBool)

IMPORT_C TInt WriteBool ( const TDesC & aField,
TBool aValuge
)

Parameters

const TDesC & aField
TBool aValuge

WriteDes(const TDesC &, const TDesC8 &)

IMPORT_C TInt WriteDes ( const TDesC & aField,
const TDesC8 & aValue
)

Parameters

const TDesC & aField
const TDesC8 & aValue

WriteDes(const TDesC &, const TDesC16 &)

IMPORT_C TInt WriteDes ( const TDesC & aField,
const TDesC16 & aValue
)

Parameters

const TDesC & aField
const TDesC16 & aValue

WriteInt(const TDesC &, TUint32)

IMPORT_C TInt WriteInt ( const TDesC & aField,
TUint32 aValue
)

Parameters

const TDesC & aField
TUint32 aValue

Member Data Documentation

TBool iOwnImpl

TBool iOwnImpl [private]

MCommsDbAccess * iPimpl

MCommsDbAccess * iPimpl [private]

Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License v1.0.