Symbian
Symbian OS Library

SYMBIAN OS V9.3

[Index] [Spacer] [Previous] [Next]



Location: MTCLREG.H
Link against: msgs.lib
Link against: msgs_autoshutdown.lib

Class CClientMtmRegistry

class CClientMtmRegistry : public CObserverRegistry;

Description

Accesses the Client-side MTM registry.

This registry holds details of the all the Client-side MTMs currently available on the system. Message client applications use this class to get a CBaseMtm-derived object by which to access Client-side MTM functionality.

Note that the base class CMtmDllRegistry provides functions for discovering what MTMs are present in the registry.

Derivation

Members

Defined in CClientMtmRegistry:
NewL(), NewMtmL(), ~CClientMtmRegistry()

Inherited from CObserverRegistry:
ConstructL(), HandleSessionEventL(), iIsAdded, iMsvSession

Inherited from MMsvSessionObserver:
EMsvCloseSession, EMsvCorruptedIndexRebuilding, EMsvCorruptedIndexRebuilt, EMsvEntriesChanged, EMsvEntriesCreated, EMsvEntriesDeleted, EMsvEntriesMoved, EMsvGeneralError, EMsvMediaAvailable, EMsvMediaChanged, EMsvMediaIncorrect, EMsvMediaUnavailable, EMsvMtmGroupDeInstalled, EMsvMtmGroupInstalled, EMsvServerFailedToStart, EMsvServerReady, EMsvServerTerminated, TMsvSessionEvent

See also


Construction and destruction


NewL()

static IMPORT_C CClientMtmRegistry *NewL(CMsvSession &aMsvSession, TTimeIntervalMicroSeconds32 aTimeoutMicroSeconds32=TTimeIntervalMicroSeconds32(30000000));

Description

Gets a CClientMtmRegistry object. The client should delete this object when it is no longer required.

The registry keeps a reference count of the number of instances of each MTM in use. When that reference count falls to zero, the DLL that provides the MTM is unloaded. However, this is not done immediately, but only after the time specified in aTimeoutMicroSeconds32. This increases efficiency in cases where the DLL is required again shortly.

Parameters

CMsvSession &aMsvSession

The client's Message Server session

TTimeIntervalMicroSeconds32 aTimeoutMicroSeconds32

Time to wait before unloading MTM DLLs

Return value

CClientMtmRegistry *

A pointer to a newly allocated and initialised object

Leave codes

KErrNoMemory

A memory allocation failed


~CClientMtmRegistry()

IMPORT_C ~CClientMtmRegistry();

Description

Destructor.

[Top]


Member functions


NewMtmL()

IMPORT_C CBaseMtm *NewMtmL(TUid aMtmTypeUid);

Description

Creates a Client-side MTM object for the specified MTM UID.

The client should delete the returned object when it is no longer required.

Parameters

TUid aMtmTypeUid

UID of MTM to obtain

Return value

CBaseMtm *

Client-side MTM object for specified MTM

Leave codes

KErrNotFound

aMtmTypeUid does not specify a registered MTM

KErrNoMemory

A memory allocation failed

KErrBadLibraryEntryPoint

Malformed MTM: a library entry point was not of the required type

DLL

loading error codes The DLL that provides the MTM cannot be loaded