Collapse all Symbian^3 Application Developer Library

MsvUiServiceUtilities Class Reference

class MsvUiServiceUtilities

Static class to help service handling.

Public Member Functions
IMPORT_C TBool	CallToSenderQueryL (const TDesC &, const TDesC &, TBool )
IMPORT_C TMsvId	DefaultServiceForMTML ( CMsvSession &, TUid , TBool )
IMPORT_C TBool	DiskSpaceBelowCriticalLevelL ( CMsvSession &, TInt )
IMPORT_C TBool	DiskSpaceBelowCriticalLevelWithOverheadL ( CMsvSession &, TInt , TInt )
IMPORT_C CMsvEntrySelection *	GetListOfAccountsL ( CMsvSession &, TBool )
IMPORT_C CMsvEntrySelection *	GetListOfAccountsWithMTML ( CMsvSession &, TUid , TBool )
IMPORT_C TBool	InternetCallServiceL (const TDesC &, const TDesC &, const TDesC &, CEikonEnv *)
IMPORT_C TBool	InternetCallToSenderQueryL (const TDesC &, const TDesC &, TBool )
IMPORT_C TBool	IsValidDomainL (const TDesC &)
IMPORT_C TBool	IsValidEmailAddressL (const TDesC &)

Private Member Functions
CMsvEntrySelection *	DoGetListOfAccountsL ( CMsvSession &, TUid , TBool )

Member Functions Documentation

CallToSenderQueryL(const TDesC &, const TDesC &, TBool)

IMPORT_C TBool	CallToSenderQueryL	(	const TDesC &	aNumber,
			const TDesC &	aName,
			TBool	aDialWithoutQueries = ETrue
		)	[static]

Deprecated!

Wrapper for identical function in MsvUiServiceUtilitiesInternal side.

Parameters

const TDesC & aNumber
const TDesC & aName
TBool aDialWithoutQueries = ETrue

DefaultServiceForMTML(CMsvSession &, TUid, TBool)

IMPORT_C TMsvId	DefaultServiceForMTML	(	CMsvSession &	aSession,
			TUid	aMtm,
			TBool	aFindFirstServiceIfNoDefault
		)	[static]

Deprecated!

Wrapper for identical function in MsvUiServiceUtilitiesInternal side.

Parameters

CMsvSession & aSession
TUid aMtm
TBool aFindFirstServiceIfNoDefault

DiskSpaceBelowCriticalLevelL(CMsvSession &, TInt)

IMPORT_C TBool	DiskSpaceBelowCriticalLevelL	(	CMsvSession &	aSession,
			TInt	aBytesToWrite
		)	[static]

Checks if the disk storage will fall below Critical Level (CL) if a number of bytes are stored to the disk. Takes account where message store resides (in c: or possible in memory card). The CL is defined by SysUtil. Usage os this function is same as SysUtil::FFSSpaceBelowCriticalLevelL.

Parameters

CMsvSession & aSession
TInt aBytesToWrite	number of bytes the caller is about to add to the disk, if known by the caller beforehand. If not known, the default value 0 checks if the current space is already below the CR.

DiskSpaceBelowCriticalLevelWithOverheadL(CMsvSession &, TInt, TInt)

IMPORT_C TBool	DiskSpaceBelowCriticalLevelWithOverheadL	(	CMsvSession &	aSession,
			TInt	aBytesToWrite,
			TInt	aPhoneMemoryOverheadBytes
		)	[static]

Checks if the disk storage will fall below critical level when performing an operation which consumes phone memory in addition to message store memory.

For example, sending consumes always memory from CDrive is current drive CDrive or not.

If current drive is not CDrive then check that free memory of CDrive is greater than aPhoneMemoryOverheadBytes plus KDRIVECCRITICALTHRESHOLD(defined in SharedDataKeys.h) . After that check that free memory of current drive is greater than aBytesToWrite plus KDRIVECCRITICALTHRESHOLD.

If current drive is CDrive then check that free memory of CDrive is greater than aPhoneMemoryOverheadBytes plus aBytesToWrite plus KDRIVECCRITICALTHRESHOLD.

Parameters

CMsvSession & aSession
TInt aBytesToWrite	number of bytes the caller is about to add to the disk, if known by the caller beforehand. If not known, the default value 0 checks if the current space is already below the CR.
TInt aPhoneMemoryOverheadBytes	Sending consumes always memory from C drive. So if current drive is memory card or other than CDrive we must check that free memory of CDrive is greater than aPhoneMemoryOverheadBytes plus KDRIVECCRITICALTHRESHOLD.

DoGetListOfAccountsL(CMsvSession &, TUid, TBool)

CMsvEntrySelection *	DoGetListOfAccountsL	(	CMsvSession &	aSession,
			TUid	aMtm,
			TBool	aAlwaysListHidden = EFalse
		)	[private, static]

internal

Parameters

CMsvSession & aSession
TUid aMtm
TBool aAlwaysListHidden = EFalse

GetListOfAccountsL(CMsvSession &, TBool)

IMPORT_C CMsvEntrySelection *	GetListOfAccountsL	(	CMsvSession &	aSession,
			TBool	aAlwaysListHidden = EFalse
		)	[static]

Collects all the services.

Parameters

CMsvSession & aSession
TBool aAlwaysListHidden = EFalse

GetListOfAccountsWithMTML(CMsvSession &, TUid, TBool)

IMPORT_C CMsvEntrySelection *	GetListOfAccountsWithMTML	(	CMsvSession &	aSession,
			TUid	aMtm,
			TBool	aAlwaysListHidden = EFalse
		)	[static]

Collects all the services of certain mtm type.

Parameters

CMsvSession & aSession
TUid aMtm
TBool aAlwaysListHidden = EFalse

InternetCallServiceL(const TDesC &, const TDesC &, const TDesC &, CEikonEnv *)

IMPORT_C TBool	InternetCallServiceL	(	const TDesC &	aSenderNumber,
			const TDesC &	aSenderName,
			const TDesC &	aNumberInFocus = KNullDesC ,
			CEikonEnv *	aEnv = NULL
		)	[static]

Deprecated!

Wrapper for identical function in MsvUiServiceUtilitiesInternal side.

Parameters

const TDesC & aSenderNumber
const TDesC & aSenderName
const TDesC & aNumberInFocus = KNullDesC
CEikonEnv * aEnv = NULL

InternetCallToSenderQueryL(const TDesC &, const TDesC &, TBool)

IMPORT_C TBool	InternetCallToSenderQueryL	(	const TDesC &	aNumber,
			const TDesC &	aName,
			TBool	aDialWithoutQueries = ETrue
		)	[static]

Deprecated!

Wrapper for identical function in MsvUiServiceUtilitiesInternal side.

Parameters

const TDesC & aNumber
const TDesC & aName
TBool aDialWithoutQueries = ETrue

IsValidDomainL(const TDesC &)

IMPORT_C TBool

IsValidDomainL

(

const TDesC &

aAddress

)

[static]

Test if aDomain is format <char>+{"."<char>+}+ Valid char is char between ' ' and Del (127). Valid domain name can not include centain special chars.

Since: 3.0

Parameters

const TDesC & aAddress

IsValidEmailAddressL(const TDesC &)

IMPORT_C TBool

IsValidEmailAddressL

(

const TDesC &

aAddress

)

[static]

Test if aAddress is format <name>'@'<domain> If <name> is between "-marks, it can contain any chars between ' ' and Del (127). Otherwise it can contain chars between ' ' and Del (127), but not centain special chars. Valid name can not contain two dots sequense. <domain>-part is tested with function IsValidDomainL.

Since: 3.0

Parameters

const TDesC & aAddress