Symbian^3 Application Developer Library >

RVmbxNumber Class Reference

class RVmbxNumber : public MCenRepNotifyHandlerCallback

RVmbxNumber

vmbx.lib
Since

Inherits from

Public Member Functions
RVmbxNumber ()
~RVmbxNumber ()
TBool AllowRefresh ( TSatRefreshType , const TSatRefreshFiles &)
IMPORT_C TBool AllowedToChangeTheNumber ()
IMPORT_C void BrandIdL ( TInt , TDes8 &)
IMPORT_C void Close ()
IMPORT_C void ConstructDefaultIconsL ( CArrayPtr < CGulIcon > *)
IMPORT_C TInt GetAlsLine ( TInt &)
IMPORT_C void GetBrandedIconL (const TDesC8 &, CFbsBitmap *&, CFbsBitmap *&)
IMPORT_C TInt GetServiceIds ( RArray < TUint > &)
IMPORT_C TInt GetServiceInfo ( TVmbxServiceInfo &)
IMPORT_C TInt GetVideoMbxNumber ( TDes &, TVmbxNumberEntry )
IMPORT_C TInt GetVmbxAddress ( TDes &, TUint )
IMPORT_C TInt GetVmbxAddressL ( TDes &)
IMPORT_C TInt GetVmbxNumber ( TDes &, TVmbxNumberEntry )
void HandleAlsChangeL ( TVmbxAlsLine )
void HandleNotifyGeneric ( TUint32 )
void HandleNotifyString ( TUint32 , const TDesC16 &)
IMPORT_C TBool IsIpVoiceMailboxServices ()
IMPORT_C TBool IsSimMemory ()
IMPORT_C TBool IsVoIPProfilesFound ()
IMPORT_C void NotifyAlsLineChangeCancel ()
IMPORT_C void NotifyAlsLineChangeL ( MVmbxAlsObserver *)
IMPORT_C void NotifyServiceChange ( MServiceNotifyHandler *)
IMPORT_C void NotifyServiceChangeCancel ()
IMPORT_C void NotifyVmbxNumberChangeCancel ()
IMPORT_C void NotifyVmbxNumberChangeL ( MVmbxNotifyHandler *, TBool )
IMPORT_C TInt Open ()
IMPORT_C TInt Open ( RMobilePhone &)
void PhoneSettingChanged ( TSSSettingsSetting , TInt )
IMPORT_C TBool QueryAddressL ( TVmbxQueryType , TDes &)
IMPORT_C TBool QueryNumberL ( TVmbxQueryType , TDes &, TBool )
IMPORT_C TBool QueryVideoMbxNumberL ( TVmbxQueryType , TDes &)
void Refresh ( TSatRefreshType , const TSatRefreshFiles &)
IMPORT_C TInt SaveVideoMbxNumber (const TDesC &, TVmbxNumberEntry )
IMPORT_C TInt SaveVmbxAddressL ( TDes &)
IMPORT_C TInt SaveVmbxNumber (const TDesC &, TVmbxNumberEntry )
TInt SaveVmbxNumberToPhone (const TDesC &, TVmbxNumberEntry )
TInt SaveVmbxNumberToSim (const TDesC &, TVmbxNumberEntry )
IMPORT_C TInt SelectTypeL ( TBool )
IMPORT_C TInt SelectTypeL ( TBool , TUint &)
Private Member Functions
RVmbxNumber (const RVmbxNumber &)
void AddBrandIconL ( CArrayPtr < CGulIcon > *, TUint , TInt &)
void AppendStrToArrayL ( TInt , CDesCArray &)
TInt BackUpSimNumber (const TDesC &, TInt )
void CalculateActualMaxLengthOnSim ( TInt )
TInt CheckDefinedNumberCountL ( TInt &, TInt &, TUint &)
TInt ClearVMBXNumberFromPhone ( TInt )
void CloseETel ()
TInt ConnectETelServer ()
void ConvertToWesternDigits ( TDes &)
TInt DoPhonebookOperation ( TVmbxPhonebookOperation , TVmbxEntry *)
void FetchNumberFromPhonebook2L ( TDes &)
TInt FetchSimNumberBackUp ( TDes &, TInt )
TInt GetVmNumFromNamStore ( TDes &, TInt )
TInt GetVmNumFromSD ( TDes &, TInt )
TInt GetVmNumFromSIM ( TDes &, TInt )
TInt GetVmNumFromVMN ( TDes &)
void HandleEmergencyDialL (const TInt )
TInt HandleNumberStores ( TInt )
TBool IsEmergencyNumberL (const TDesC &)
TBool IsInactiveLineEdited ( TInt &)
TBool IsNoNumberNoteAllowed ()
TBool IsPhoneMemForcedEdit (const TInt )
TBool IsReadOnlySIM ()
TBool IsValidPhoneNumber (const TDesC &)
void LoadResourceL ()
TInt MailboxNumbersIdentifiers ()
TBool NumStoredInPhone (const TDesC &, TInt )
TInt PhoneBookInfo ()
TInt PhonebookDelete ( TVmbxEntry &)
void PhonebookReadL ( TVmbxEntry &)
TInt PhonebookWrite ( TVmbxEntry &)
TBool QuerySimNumberL ( TDes &, TVmbxNumberEntry )
TInt ResetUserEditNumber ( TInt )
void SetHeaderFromResourceL ( TInt , CAknQueryDialog &)
TInt SetPhoneMemForcedEdit ( TInt )
TInt SetUserEditNumber ( TInt )
void ShowConfirmationNoteL ( TInt )
void ShowInformationNoteL (const TInt )
void SubscribeSATNotificationsL ()
void TestAndSetSimAccessFlags ()
TBool UseSimNumIfAvailable ( TDes &, TInt )
TBool UserEditNumber ( TInt )
TBool UsesSimMemory ()
TBool VideoSupported ()
TBool VmbxNumDefInPhoneMemory ( TInt )
RVmbxNumber & operator= (const RVmbxNumber &)
Inherited Functions
MCenRepNotifyHandlerCallback::HandleNotifyBinary(TUint32,const TDesC8 &)
MCenRepNotifyHandlerCallback::HandleNotifyError(TUint32,TInt,CCenRepNotifyHandler *)
MCenRepNotifyHandlerCallback::HandleNotifyInt(TUint32,TInt)
MCenRepNotifyHandlerCallback::HandleNotifyReal(TUint32,TReal)
Public Member Enumerations
enum TVmVmQueryStatusType { EVmQueryNormal  = 0, EVmQueryProcess }
Private Attributes
TBool iAlphaStringFound
HBufC * iAlphaStringFromSIM
TBool * iClosedPtr
CPhCntSingleItemFetch * iCntFetch
CCoeEnv * iCoeEnv
TBool iFeatMgrInitialized
TInt iFlags
TBool iMbdnPhonebookOk
TInt iMemoryLocation
TBool iNoNumberFound
MVmbxNotifyHandler * iNotifyCallBack
CCenRepNotifyHandler * iNotifyHandler
TBool iNumberFound
TBuf < KVmbxMaxNumberLength > iNumberFromSim
RSat::TRefreshFileList iObservedFileList
RMobilePhone iPhone
RMobilePhoneBookStore iPhoneBook
RMobilePhoneBookStore::TMobilePhoneBookInfoV1 iPhoneBookInfo
RMobilePhoneBookStore::TMobilePhoneBookInfoV1Pckg iPhoneBookInfoPckg
TUint8 iPhoneBookType
RMobilePhone::TMobilePhoneVoicemailIdsV3 iPhoneVoicemailInfo
RMobilePhone::TMobilePhoneVoicemailIdsV3Pckg iPhoneVoicemailInfoPckg
CVmTextQueryDialog * iQuery
TVmVmQueryStatusType iQueryingState
RSatRefresh iRSatClient
RSatSession iRSatSession
TInt iResourceFileOffset
CRepository * iSession
TBool iSimCardFound
RSSSettings iSsSettings
TBool iStartUpTest
TBool iSynchronize
RTelServer iTelServer
TInt iType
CAknListQueryDialog * iTypeSelectionQuery
TBool iUSimFirstRoundTest
MVmbxAlsObserver * iUserAlsObserver
CVMSimQueryDilaog * iVMSimQueryDialog
CVmTextQueryDialog * iVideoQuery
CVmBSHandler * iVmBsHandler
TInt iVmNumOpts
CVmSPSHandler * iVmSpsHandler
TInt iVmUiOpts
RArray < TVmbxServiceSelection > iVmbxServiceSelection

Constructor & Destructor Documentation

RVmbxNumber()

IMPORT_C RVmbxNumber ( )

C++ default constructor.

RVmbxNumber(const RVmbxNumber &)

RVmbxNumber ( const RVmbxNumber & ) [private]

Parameters

const RVmbxNumber &

~RVmbxNumber()

IMPORT_C ~RVmbxNumber ( )

Destructor.

Member Functions Documentation

AddBrandIconL(CArrayPtr< CGulIcon > *, TUint, TInt &)

void AddBrandIconL ( CArrayPtr < CGulIcon > * aIcons,
TUint aServiceId,
TInt & aIconId
) [private]
Add brand icon if it exist.
Since
S60 3.2

Parameters

CArrayPtr < CGulIcon > * aIcons On completion, contains new brand icon
TUint aServiceId Used Service Id
TInt & aIconId On completion, contains branded icon's icon list id

AllowRefresh(TSatRefreshType, const TSatRefreshFiles &)

TBool AllowRefresh ( TSatRefreshType aType,
const TSatRefreshFiles & aFiles
)
Refresh query. Client should determine whether it allow the refresh to happen.
Since
2.6

Parameters

TSatRefreshType aType Refresh type.
const TSatRefreshFiles & aFiles Elementary files which are to be changed. May be zero length.

AllowedToChangeTheNumber()

IMPORT_C TBool AllowedToChangeTheNumber ( )
Check wether the voice mailbox number can be changed. If the number cannot be edited, the QueryNumberL leaves with and SaveVmbxNumber returns KErrAccessDenied.
Since
2.7

AppendStrToArrayL(TInt, CDesCArray &)

void AppendStrToArrayL ( TInt aResourceId,
CDesCArray & aArray
) [private]
Appends string from resource to descriptor array
Since

Parameters

TInt aResourceId Resource id
CDesCArray & aArray String array

BackUpSimNumber(const TDesC &, TInt)

TInt BackUpSimNumber ( const TDesC & aNumber,
TInt aLineNumber
) [private]
Saves VMBX number to the backup store
Since
S60 3.2

Parameters

const TDesC & aNumber The number to be saved
TInt aLineNumber Line 1 or 2

BrandIdL(TInt, TDes8 &)

IMPORT_C void BrandIdL ( TInt aServiceId,
TDes8 & aBrandId
)
Get Service's Brand Id
Since
S60 3.2

Parameters

TInt aServiceId Used Service Id
TDes8 & aBrandId On completion, contains Brand Id

CalculateActualMaxLengthOnSim(TInt)

void CalculateActualMaxLengthOnSim ( TInt aSimNumberLength ) [private]
The actual size for number must be determine from max length returned from GetInfo-method and saved number length on Sim.
Since

Parameters

TInt aSimNumberLength The length of the number read from sim.

CheckDefinedNumberCountL(TInt &, TInt &, TUint &)

TInt CheckDefinedNumberCountL ( TInt & aDefinedNumber,
TInt & aDefinedFlag,
TUint & aServiceId
) [private]
check count of VMBX number available
Since
S60 3.2.2

Parameters

TInt & aDefinedNumber
TInt & aDefinedFlag
TUint & aServiceId

ClearVMBXNumberFromPhone(TInt)

TInt ClearVMBXNumberFromPhone ( TInt aLineNumber ) [private]
Clears VMBX number from the phone memory
Since
S60 3.2

Parameters

TInt aLineNumber Line 1 or 2

Close()

IMPORT_C void Close ( )

Closes the resources allocated in Open() .

Cancels all issued notify requests.

CloseETel()

void CloseETel ( ) [private]
Closes ETel resources
Since

ConnectETelServer()

TInt ConnectETelServer ( ) [private]
Create connection to ETel server
Since

ConstructDefaultIconsL(CArrayPtr< CGulIcon > *)

IMPORT_C void ConstructDefaultIconsL ( CArrayPtr < CGulIcon > * aIcons )
Construct default icons(CS, Video and VoIP)
Since
S60 3.2

Parameters

CArrayPtr < CGulIcon > * aIcons On completion, contains created icons

ConvertToWesternDigits(TDes &)

void ConvertToWesternDigits ( TDes & aDes ) const [private]

Converts a phone number to western format

Parameters

TDes & aDes Parameter to change

DoPhonebookOperation(TVmbxPhonebookOperation, TVmbxEntry *)

TInt DoPhonebookOperation ( TVmbxPhonebookOperation aOperation,
TVmbxEntry * aEntry = NULL
) [private]

Does a vmbx phonebook operation

If the phonebook is being cached, defined amount of retries are made with 0.2 second delay in between.

Parameters

TVmbxPhonebookOperation aOperation Operation identifier
TVmbxEntry * aEntry = NULL Vmbx entry (NULL)

FetchNumberFromPhonebook2L(TDes &)

void FetchNumberFromPhonebook2L ( TDes & aPhoneNumber ) [private]
Open phonebook's Single Fetch Dialog
Since

Parameters

TDes & aPhoneNumber Phone number

FetchSimNumberBackUp(TDes &, TInt)

TInt FetchSimNumberBackUp ( TDes & aNumber,
TInt aLineNumber
) [private]
Fetches VMBX number from backup store
Since
S60 3.2

Parameters

TDes & aNumber number
TInt aLineNumber Line 1 or 2

GetAlsLine(TInt &)

IMPORT_C TInt GetAlsLine ( TInt & aLineNumber ) const

Gets the currently active ALS line number ( 1 or 2 ). Information is fetched from supplementary settings client.

Parameters

TInt & aLineNumber line number is returned here. If ALS is not supported, value 1 is returned.

GetBrandedIconL(const TDesC8 &, CFbsBitmap *&, CFbsBitmap *&)

IMPORT_C void GetBrandedIconL ( const TDesC8 & aBrandingId,
CFbsBitmap *& aBrandedBitmap,
CFbsBitmap *& aBrandedBitmapMask
)
Branded icon getter
Since
S60 3.2

Parameters

const TDesC8 & aBrandingId Used branding Id
CFbsBitmap *& aBrandedBitmap Bitmap for branded icon
CFbsBitmap *& aBrandedBitmapMask Mask to branded icon

GetServiceIds(RArray< TUint > &)

IMPORT_C TInt GetServiceIds ( RArray < TUint > & aProfileIds )
Service Ids getter
Since
3.2

Parameters

RArray < TUint > & aProfileIds On completion, contains all Service Ids.

GetServiceInfo(TVmbxServiceInfo &)

IMPORT_C TInt GetServiceInfo ( TVmbxServiceInfo & aServiceInfo )
Service info getter
Since
3.2

Parameters

TVmbxServiceInfo & aServiceInfo On completion, contains Service information

GetVideoMbxNumber(TDes &, TVmbxNumberEntry)

IMPORT_C TInt GetVideoMbxNumber ( TDes & aNumber,
TVmbxNumberEntry aEntry = EAlsActiveLineEntry
)
Fetches the specified video mailbox number. If there is no video mailbox number saved for the specified ALS line, parameter aNumber remains unchanged and the return value is KErrNotFound.
Since
3.1

  • KErrNotFound if the number is not defined

  • Other error code if there was a problem in getting the number. Clients should show error note if this happens.

Parameters

TDes & aNumber video mailbox number is saved here (must be room for at least KVmbxMaxNumberLength characters)
TVmbxNumberEntry aEntry = EAlsActiveLineEntry determines which video mbx number entry is used: EAlsLine1Entry = video mbx number entry of primary line EAlsLine2Entry = video mbx number entry of secondary line EAlsActiveLineEntry = entry of currently active line

GetVmNumFromNamStore(TDes &, TInt)

TInt GetVmNumFromNamStore ( TDes & aNumber,
TInt aNumType = EVmbxMDN
) [private]
Retrieves voice mailbox number from NAM
Since

Parameters

TDes & aNumber Number
TInt aNumType = EVmbxMDN Number type (EVmbxMDN)

GetVmNumFromSD(TDes &, TInt)

TInt GetVmNumFromSD ( TDes & aNumber,
TInt aLineNumber
) [private]
Retrieves voice mailbox number from Shared Data
Since

Parameters

TDes & aNumber Number
TInt aLineNumber Line 1 or 2

GetVmNumFromSIM(TDes &, TInt)

TInt GetVmNumFromSIM ( TDes & aNumber,
TInt aLineNumber
) [private]
Retrieves voice mailbox number from SIM/R-UIM
Since

Parameters

TDes & aNumber Number
TInt aLineNumber Line 1 or 2

GetVmNumFromVMN(TDes &)

TInt GetVmNumFromVMN ( TDes & aNumber ) [private]
Retrieves voice mailbox number from VMN summary info
Since

Parameters

TDes & aNumber Number

GetVmbxAddress(TDes &, TUint)

IMPORT_C TInt GetVmbxAddress ( TDes & aAddress,
TUint aServiceId
)
Fetches vmbx address from SPS.
Since
3.2

Parameters

TDes & aAddress vmbx address is saved here (must be room for at least KVmbxMaxAddressLength characters).
TUint aServiceId Used Service Id

GetVmbxAddressL(TDes &)

IMPORT_C TInt GetVmbxAddressL ( TDes & aAddress )
Fetches vmbx address from SPS.
Since
3.0

  • KErrNotFound if the address is not defined

  • Other error code if there was a problem in getting the address. Clients should show error note if this happens.

Parameters

TDes & aAddress vmbx address is saved here (must be room for at least KVmbxMaxAddressLength characters).

GetVmbxNumber(TDes &, TVmbxNumberEntry)

IMPORT_C TInt GetVmbxNumber ( TDes & aNumber,
TVmbxNumberEntry aEntry = EAlsActiveLineEntry
)

Fetches the specified vmbx number. If there is no vmbx number saved for the specified ALS line, parameter aNumber remains unchanged and the return value is KErrNotFound.

  • KErrNotFound if the number is not defined

  • Other error code if there was a problem in getting the number. Clients should show error note if this happens.

Parameters

TDes & aNumber vmbx number is saved here (must be room for at least KVmbxMaxNumberLength characters)
TVmbxNumberEntry aEntry = EAlsActiveLineEntry determines which vmbx number entry is used: EAlsLine1Entry = vmbx number entry of primary line EAlsLine2Entry = vmbx number entry of secondary line EAlsActiveLineEntry = entry of currently active line

HandleAlsChangeL(TVmbxAlsLine)

void HandleAlsChangeL ( TVmbxAlsLine aLine )

From MVmbxAlsObserver :

Parameters

TVmbxAlsLine aLine

HandleEmergencyDialL(const TInt)

void HandleEmergencyDialL ( const TInt aStatus ) [private]
Handling of emergency dial result.
Since
3.2
MPhCltEmergencyCallObserver::HandleEmergencyDialL().

Parameters

const TInt aStatus

HandleNotifyGeneric(TUint32)

void HandleNotifyGeneric ( TUint32 aKey ) [virtual]

From MCenRepNotifyHandlerCallback , to notify the client about changes in keys when the whole repository is listened for.

Parameters

TUint32 aKey

HandleNotifyString(TUint32, const TDesC16 &)

void HandleNotifyString ( TUint32 aKey,
const TDesC16 & aValue
) [virtual]

From MCenRepNotifyHandlerCallback , to notify the client about changes for string value keys

Parameters

TUint32 aKey
const TDesC16 & aValue

HandleNumberStores(TInt)

TInt HandleNumberStores ( TInt aLineNumber ) [private]
Handles the updating of a number stores in phone memory
Since
S60 3.2

Parameters

TInt aLineNumber Line 1 or 2

IsEmergencyNumberL(const TDesC &)

TBool IsEmergencyNumberL ( const TDesC & aNumber ) [private]
Checks if a number is an emergency number.
Since

Parameters

const TDesC & aNumber Vmbx number

IsInactiveLineEdited(TInt &)

TBool IsInactiveLineEdited ( TInt & aInactiveLineNumber ) [private]
Check whether the number had been edited in inactive line
Since
S60 v5.2

Parameters

TInt & aInactiveLineNumber the inactive line number

IsIpVoiceMailboxServices()

IMPORT_C TBool IsIpVoiceMailboxServices ( )
Check if VoIP voice mailbox services exists
Since
5.0

IsNoNumberNoteAllowed()

TBool IsNoNumberNoteAllowed ( ) [private]
Check whether the note should be shown this check is done because phone client calls GetVmbxNumber and then SelectTypeL, which causes note qtn_... to be shown twice
Since
S60 v5.2

IsPhoneMemForcedEdit(const TInt)

TBool IsPhoneMemForcedEdit ( const TInt aLineNumber ) [private]
Returns if VMBX number stored in phone memory via external clients
Since
S60 3.2.3

Parameters

const TInt aLineNumber Line 1 or 2

IsReadOnlySIM()

TBool IsReadOnlySIM ( ) [private]
Checks if writing to sim is prohibited
Since
S60 3.2 return ETrue if writing is not allowed

IsSimMemory()

IMPORT_C TBool IsSimMemory ( )
Returns if the memory location for vmbx is sim memory
Since
3.0

IsValidPhoneNumber(const TDesC &)

TBool IsValidPhoneNumber ( const TDesC & aNumber ) const [private]

Verifies that the given string is a valid phone number. Rules:

  • '+' is only allowed as the first character

  • The phone number part must have 3-21 digits
    Since

Parameters

const TDesC & aNumber Vmbx number

IsVoIPProfilesFound()

IMPORT_C TBool IsVoIPProfilesFound ( )
Check if VoIP profiles exists.
Since
3.0

LoadResourceL()

void LoadResourceL ( ) [private]
Loads the resources needed for queries and confirmation notes.
Since

MailboxNumbersIdentifiers()

TInt MailboxNumbersIdentifiers ( ) [private]
Gets MBI-file settings from Sim. MBI-file identifies the usage of the mailbox records settings
Since

NotifyAlsLineChangeCancel()

IMPORT_C void NotifyAlsLineChangeCancel ( )

Cancels a notify request on ALS line change.

NotifyAlsLineChangeL(MVmbxAlsObserver *)

IMPORT_C void NotifyAlsLineChangeL ( MVmbxAlsObserver * aObserver )

Issues a notify request on active ALS line change. A callback to user's code is made when the ALS line is changed. The notify request remains active as long as it is canceled with NotifyAlsLineChangeCancel() , ie. it is not canceled when the ALS line is changed. Implementation uses SharedData's notify system. Leaves if the notify request could not be done.

Parameters

MVmbxAlsObserver * aObserver user's observer

NotifyServiceChange(MServiceNotifyHandler *)

IMPORT_C void NotifyServiceChange ( MServiceNotifyHandler * aHandler )

Issues a notify request on a Service profile change.

Parameters

MServiceNotifyHandler * aHandler User's notify handler

NotifyServiceChangeCancel()

IMPORT_C void NotifyServiceChangeCancel ( )

Cancels a notify request on a Service profile change.

NotifyVmbxNumberChangeCancel()

IMPORT_C void NotifyVmbxNumberChangeCancel ( )

Cancels a notify request on a vmbx number change.

NotifyVmbxNumberChangeL(MVmbxNotifyHandler *, TBool)

IMPORT_C void NotifyVmbxNumberChangeL ( MVmbxNotifyHandler * aHandler,
TBool aNotifyOnActiveLineOnly
)

Issues a notify request on a vmbx number change. User's HandleNotifyL() will be called whenever the vmbx number has been changed by any subsystem. Only one notify request can be done per one RVmbxNumber object simultaneously. When issuing a notify request while one is active already, only parameters aHandler and aNotifyOnActiveLineOnly are updated in existing request.

Leaves if the notify request could not be done.

Parameters

MVmbxNotifyHandler * aHandler user's notify handler
TBool aNotifyOnActiveLineOnly if this is ETrue, notify events will be generated only if the vmbx number of the active ALS line is changed, not if the number of the other line is changed. When there is no ALS support, this has no effect ie. notification will be generated always.

NumStoredInPhone(const TDesC &, TInt)

TBool NumStoredInPhone ( const TDesC & aNumber,
TInt aLineNumber
) [private]
Checks is the given number stored in phone memory
Since
S60 3.2

Parameters

const TDesC & aNumber The number checked
TInt aLineNumber Line 1 or 2

Open()

IMPORT_C TInt Open ( )

Opens the resources needed. This or the other overloaded Open() has to be called successfully before doing anything else.

---------------------------------------------------------------------- A new ETel connection is opened when using this method! ----------------------------------------------------------------------

Open(RMobilePhone &)

IMPORT_C TInt Open ( RMobilePhone & aPhone )

Opens the resources needed. This or the other overloaded Open() has to be called successfully before doing anything else.

Use this overload if you already have ETel connection.

---------------------------------------------------------------------- An existing ETel connection is used when using this method! ----------------------------------------------------------------------

Parameters

RMobilePhone & aPhone Phone client

PhoneBookInfo()

TInt PhoneBookInfo ( ) [private]

Fetches information about the SIM phonebook for vmbx numbers. Updates internal flags KVmFlagSimSupport and KVmFlagPhonebookBeingCached.

PhoneSettingChanged(TSSSettingsSetting, TInt)

void PhoneSettingChanged ( TSSSettingsSetting aSetting,
TInt aNewValue
)

From MSSSettingsObserver , to notify changes in SS settings in phone

Parameters

TSSSettingsSetting aSetting
TInt aNewValue

PhonebookDelete(TVmbxEntry &)

TInt PhonebookDelete ( TVmbxEntry & aEntry ) [private]
Removes an entry from ICC-based phonebook.
Since

Parameters

TVmbxEntry & aEntry Vmbx sim entry data

PhonebookReadL(TVmbxEntry &)

void PhonebookReadL ( TVmbxEntry & aEntry ) [private]
Reads an entry from the ICC-based phonebook.
Since

Parameters

TVmbxEntry & aEntry Vmbx sim entry data

PhonebookWrite(TVmbxEntry &)

TInt PhonebookWrite ( TVmbxEntry & aEntry ) [private]
Writes an entry into ICC-based phonebook.
Since

Parameters

TVmbxEntry & aEntry Vmbx sim entry data

QueryAddressL(TVmbxQueryType, TDes &)

IMPORT_C TBool QueryAddressL ( TVmbxQueryType aQueryType,
TDes & aNumber
)
Puts a query on the screen asking for a voice mailbox address.
Since
3.0
IMPORTANT:

Other subsystems than voice mailbox application should call this ONLY IF GetVmbxNumber() returned KErrNotFound. Also, only the parameter EVmbxNotDefinedQuery should be used outside the voice mailbox application.

  • EVmbxChangeNumberQuery

Parameters

TVmbxQueryType aQueryType type of the query, alternatives:EVmbxNotDefinedQuery (use this when no vmbx address is defined)
TDes & aNumber Initial value for the query, AND the result value of an accepted query. (must be room for at least KVmbxMaxAddressLength characters. Not allowed to contain longer initial value than KVmbxMaxAddressLength)

QueryNumberL(TVmbxQueryType, TDes &, TBool)

IMPORT_C TBool QueryNumberL ( TVmbxQueryType aQueryType,
TDes & aNumber,
TBool aShowQuery = EFalse
)

Puts a query on the screen asking for a voice mailbox number.

IMPORTANT:

Other subsystems than voice mailbox application should call this ONLY IF GetVmbxNumber() returned KErrNotFound. Also, only the parameter EVmbxNotDefinedQuery should be used outside the voice mailbox application.

  • EVmbxChangeNumberQuery

Parameters

TVmbxQueryType aQueryType type of the query, alternatives:EVmbxNotDefinedQuery (use this when no vmbx number is defined)
TDes & aNumber Initial value for the query, AND the result value of an accepted query. (must be room for at least KVmbxMaxNumberLength characters. Not allowed to contain longer initial value than KVmbxMaxNumberLength)
TBool aShowQuery = EFalse When this is set and the sim has support for vmbx number the user is shown a list query by which the storage of sim number can be decided

QuerySimNumberL(TDes &, TVmbxNumberEntry)

TBool QuerySimNumberL ( TDes & aNumber,
TVmbxNumberEntry aEntry = EAlsActiveLineEntry
) [private]
Routine to query SIM number
Since

Parameters

TDes & aNumber Vmbx number
TVmbxNumberEntry aEntry = EAlsActiveLineEntry Als line entry

QueryVideoMbxNumberL(TVmbxQueryType, TDes &)

IMPORT_C TBool QueryVideoMbxNumberL ( TVmbxQueryType aQueryType,
TDes & aNumber
)
Puts a query on the screen asking for a video mailbox number.
Since
3.1
IMPORTANT:

Other subsystems than voice mailbox application should call this ONLY IF GetVideoMbxNumber() returned KErrNotFound. Also, only the parameter EVmbxNotDefinedQuery should be used outside the voice mailbox application.

Parameters

TVmbxQueryType aQueryType type of the query, alternatives:EVmbxNotDefinedQuery (use this when no vmbx number is defined)EVmbxChangeNumberQuery
TDes & aNumber Initial value for the query, AND the result value of an accepted query. (must be room for at least KVmbxMaxNumberLength characters. Not allowed to contain longer initial value than KVmbxMaxNumberLength)

Refresh(TSatRefreshType, const TSatRefreshFiles &)

void Refresh ( TSatRefreshType aType,
const TSatRefreshFiles & aFiles
)
Notification of refresh.
Since
2.6

Parameters

TSatRefreshType aType Type of refresh which has happened.
const TSatRefreshFiles & aFiles List of elementary files which has been changed. May be zero length.

ResetUserEditNumber(TInt)

TInt ResetUserEditNumber ( TInt aLineNumber ) [private]
Resets the flag that indicates that the user has edited VMBX number
Since
S60 3.2

Parameters

TInt aLineNumber Line 1 or 2

SaveVideoMbxNumber(const TDesC &, TVmbxNumberEntry)

IMPORT_C TInt SaveVideoMbxNumber ( const TDesC & aNumber,
TVmbxNumberEntry aEntry
)
Saves the vmbx number. (in phone file system)
Since
3.1

Parameters

const TDesC & aNumber video mbx number ( max length is KVmbxMaxNumberLength )
TVmbxNumberEntry aEntry determines in which entry the number is saved: EAlsLine1Entry = video mbx number entry of ALS primary line EAlsLine2Entry = video mbx number entry of ALS secondary line EAlsActiveLineEntry = entry of currently active ALS line

SaveVmbxAddressL(TDes &)

IMPORT_C TInt SaveVmbxAddressL ( TDes & aAddress )
Save address.
Since
3.0

Parameters

TDes & aAddress includes saved vmbx address

SaveVmbxNumber(const TDesC &, TVmbxNumberEntry)

IMPORT_C TInt SaveVmbxNumber ( const TDesC & aNumber,
TVmbxNumberEntry aEntry
)

Saves the vmbx number. (in phone file system and SIM)

Parameters

const TDesC & aNumber vmbx number ( max length is KVmbxMaxNumberLength )
TVmbxNumberEntry aEntry determines in which entry the number is saved: EAlsLine1Entry = vmbx number entry of ALS primary line EAlsLine2Entry = vmbx number entry of ALS secondary line EAlsActiveLineEntry = entry of currently active ALS line

SaveVmbxNumberToPhone(const TDesC &, TVmbxNumberEntry)

TInt SaveVmbxNumberToPhone ( const TDesC & aNumber,
TVmbxNumberEntry aEntry
)
Saves vmbx number to phone memory
Since

Parameters

const TDesC & aNumber Vmbx number
TVmbxNumberEntry aEntry Als line entry

SaveVmbxNumberToSim(const TDesC &, TVmbxNumberEntry)

TInt SaveVmbxNumberToSim ( const TDesC & aNumber,
TVmbxNumberEntry aEntry
)
Saves vmbx number to Sim
Since

Parameters

const TDesC & aNumber Vmbx number
TVmbxNumberEntry aEntry Als line entry

SelectTypeL(TBool)

IMPORT_C TInt SelectTypeL ( TBool aTitle )
Puts a popup on the screen asking for which type of Vmbx is used.
Since
3.0

Parameters

TBool aTitle Vmbx title type ( call / define ).

SelectTypeL(TBool, TUint &)

IMPORT_C TInt SelectTypeL ( TBool aTitle,
TUint & aServiceId
)
Puts a popup on the screen asking for which type of Vmbx is used.
Since
3.2

Parameters

TBool aTitle Vmbx title type ( call / define ).
TUint & aServiceId On completion, contains selected service's Service Id. If CS or Video Vmbx selected, value is 1, otherwise service's value is dynamic.

SetHeaderFromResourceL(TInt, CAknQueryDialog &)

void SetHeaderFromResourceL ( TInt aResourceId,
CAknQueryDialog & aDlg
) [private]
Set query dialog header text from resource string
Since

Parameters

TInt aResourceId Resource id
CAknQueryDialog & aDlg Query dialog

SetPhoneMemForcedEdit(TInt)

TInt SetPhoneMemForcedEdit ( TInt aLineNumber ) [private]
Sets the flag indicating that external clients has edited VMBX number
Since
S60 3.2.3

Parameters

TInt aLineNumber Line 1 or 2

SetUserEditNumber(TInt)

TInt SetUserEditNumber ( TInt aLineNumber ) [private]
Sets the flag indicating that the user has edited VMBX number
Since
S60 3.2

Parameters

TInt aLineNumber Line 1 or 2

ShowConfirmationNoteL(TInt)

void ShowConfirmationNoteL ( TInt aResourceId ) const [private]

Shows a confirmation note after a saved vmbx number.

Parameters

TInt aResourceId Resource id

ShowInformationNoteL(const TInt)

void ShowInformationNoteL ( const TInt aResourceId ) const [private]
Displays a note with a text loaded from resource file.
Since
S60 v5.2

Parameters

const TInt aResourceId Resource id for loading text for note

SubscribeSATNotificationsL()

void SubscribeSATNotificationsL ( ) [private]
Subscribe SAT notifications
Since

TestAndSetSimAccessFlags()

void TestAndSetSimAccessFlags ( ) [private]
Reading and writing to sim are tested
Since

UseSimNumIfAvailable(TDes &, TInt)

TBool UseSimNumIfAvailable ( TDes & aNumber,
TInt aLineNumber
) [private]
Fetches VMBX number stored in SIM if number is available
Since
S60 3.2

Parameters

TDes & aNumber number
TInt aLineNumber Line 1 or 2

UserEditNumber(TInt)

TBool UserEditNumber ( TInt aLineNumber ) [private]
Indicates if user has edited VMBX number
Since
S60 3.2

Parameters

TInt aLineNumber Line 1 or 2

UsesSimMemory()

TBool UsesSimMemory ( ) [private]
Returns if the SIM memory is used on ALS 1
Since
3.2

VideoSupported()

TBool VideoSupported ( ) [private]
Returns video support state
Since
S60 3.2 return ETrue if supported

VmbxNumDefInPhoneMemory(TInt)

TBool VmbxNumDefInPhoneMemory ( TInt aLineNumber ) [private]
Checks is VMBX number defined in phone memory
Since
S60 3.2

Parameters

TInt aLineNumber Line 1 or 2

operator=(const RVmbxNumber &)

RVmbxNumber & operator= ( const RVmbxNumber & ) [private]

Parameters

const RVmbxNumber &

Member Enumerations Documentation

Enum TVmVmQueryStatusType

status for QueryNumberL. EVmQueryNormal Query number running normal case EVmQueryProcess Query number running FOREVER case

Enumerators

EVmQueryNormal = 0
EVmQueryProcess

Member Data Documentation

TBool iAlphaStringFound

TBool iAlphaStringFound [private]

HBufC * iAlphaStringFromSIM

HBufC * iAlphaStringFromSIM [private]

TBool * iClosedPtr

TBool * iClosedPtr [private]

CPhCntSingleItemFetch * iCntFetch

CPhCntSingleItemFetch * iCntFetch [private]

For single item fetch

CCoeEnv * iCoeEnv

CCoeEnv * iCoeEnv [private]

TBool iFeatMgrInitialized

TBool iFeatMgrInitialized [private]

Feature manager is initialized

TInt iFlags

TInt iFlags [private]

TBool iMbdnPhonebookOk

TBool iMbdnPhonebookOk [private]

To test if number can be found from vmbx-phonebook

TInt iMemoryLocation

TInt iMemoryLocation [private]

TBool iNoNumberFound

TBool iNoNumberFound [private]

To test if mbdn number doesn't exist

MVmbxNotifyHandler * iNotifyCallBack

MVmbxNotifyHandler * iNotifyCallBack [private]

CCenRepNotifyHandler * iNotifyHandler

CCenRepNotifyHandler * iNotifyHandler [private]

TBool iNumberFound

TBool iNumberFound [private]

TBuf< KVmbxMaxNumberLength > iNumberFromSim

TBuf < KVmbxMaxNumberLength > iNumberFromSim [private]

RSat::TRefreshFileList iObservedFileList

RSat::TRefreshFileList iObservedFileList [private]

RMobilePhone iPhone

RMobilePhone iPhone [private]

RMobilePhoneBookStore iPhoneBook

RMobilePhoneBookStore iPhoneBook [private]

RMobilePhoneBookStore::TMobilePhoneBookInfoV1 iPhoneBookInfo

RMobilePhoneBookStore::TMobilePhoneBookInfoV1 iPhoneBookInfo [private]

RMobilePhoneBookStore::TMobilePhoneBookInfoV1Pckg iPhoneBookInfoPckg

RMobilePhoneBookStore::TMobilePhoneBookInfoV1Pckg iPhoneBookInfoPckg [private]

TUint8 iPhoneBookType

TUint8 iPhoneBookType [private]

RMobilePhone::TMobilePhoneVoicemailIdsV3 iPhoneVoicemailInfo

RMobilePhone::TMobilePhoneVoicemailIdsV3 iPhoneVoicemailInfo [private]

RMobilePhone::TMobilePhoneVoicemailIdsV3Pckg iPhoneVoicemailInfoPckg

RMobilePhone::TMobilePhoneVoicemailIdsV3Pckg iPhoneVoicemailInfoPckg [private]

CVmTextQueryDialog * iQuery

CVmTextQueryDialog * iQuery [private]

TVmVmQueryStatusType iQueryingState

TVmVmQueryStatusType iQueryingState [private]

querying state of QueryNumberL

RSatRefresh iRSatClient

RSatRefresh iRSatClient [private]

RSatSession iRSatSession

RSatSession iRSatSession [private]

TInt iResourceFileOffset

TInt iResourceFileOffset [private]

CRepository * iSession

CRepository * iSession [private]

TBool iSimCardFound

TBool iSimCardFound [private]

Sim card is whether found in ME

RSSSettings iSsSettings

RSSSettings iSsSettings [private]

TBool iStartUpTest

TBool iStartUpTest [private]

True if Sim access rights are tested

TBool iSynchronize

TBool iSynchronize [private]

RTelServer iTelServer

RTelServer iTelServer [private]

TInt iType

TInt iType [private]

CAknListQueryDialog * iTypeSelectionQuery

CAknListQueryDialog * iTypeSelectionQuery [private]

TBool iUSimFirstRoundTest

TBool iUSimFirstRoundTest [private]

MVmbxAlsObserver * iUserAlsObserver

MVmbxAlsObserver * iUserAlsObserver [private]

CVMSimQueryDilaog * iVMSimQueryDialog

CVMSimQueryDilaog * iVMSimQueryDialog [private]

CVmTextQueryDialog * iVideoQuery

CVmTextQueryDialog * iVideoQuery [private]

CVmBSHandler * iVmBsHandler

CVmBSHandler * iVmBsHandler [private]

Handles Branding Server, Own.

TInt iVmNumOpts

TInt iVmNumOpts [private]

CVmSPSHandler * iVmSpsHandler

CVmSPSHandler * iVmSpsHandler [private]

Handles Service proviver Settings, Own.

TInt iVmUiOpts

TInt iVmUiOpts [private]

RArray< TVmbxServiceSelection > iVmbxServiceSelection

RArray < TVmbxServiceSelection > iVmbxServiceSelection [private]

Type and Id of mailboxes to list in iTypeSelectionQuery, Own

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.