Symbian
Symbian OS Library

SYMBIAN OS V9.3

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



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

Class CMtmGroupData

class CMtmGroupData : public CBase;

Description

Encapsulates the registration data for an MTM group.

It is used to access and write the registration data file for an MTM group.

Derivation

Members

Defined in CMtmGroupData:
ExternalizeL(), GetMtmRequiredCapabilities(), InternalizeL(), MtmDllInfoArray(), MtmTypeUid(), NewL(), NewL(), NewL(), TechnologyTypeUid(), operator==(), ~CMtmGroupData()

Inherited from CBase:
Delete(), Extension_(), operator new()


Construction and destruction


NewL()

static IMPORT_C CMtmGroupData *NewL(TUid aMtmTypeUid, TUid aTechnologyTypeUid, CMtmDllInfoArray *aMtmDllInfoArray, const TCapabilitySet &aMtmRequiredCaps);

Description

Creates a new CMtmGroupData and initialise it with registration data for an MTM group.

Parameters

TUid aMtmTypeUid

UID that uniquely identifies the MTM group

TUid aTechnologyTypeUid

UID that can be used to indicate the messaging technology which the MTM group implements

CMtmDllInfoArray *aMtmDllInfoArray

Array of registration data for the MTM components in the group. This function takes immediate responsibility for aMtmDllInfoArray, so it should not be on the cleanup stack prior to the call. If successful, the newly created CMtmGroupData takes ownership of the object

const TCapabilitySet &aMtmRequiredCaps

The required security capabilities for this MTM group

Return value

CMtmGroupData *

New initialised CMtmGroupData

Leave codes

KErrNoMemory

A memory allocation failed


NewL()

static IMPORT_C CMtmGroupData *NewL(const CMtmGroupData &aMtmGroupData);

Description

Creates a new CMtmGroupData and initialises it with another CMtmGroupData

Parameters

const CMtmGroupData &aMtmGroupData

Return value

CMtmGroupData *

New initialised CMtmGroupData

Leave codes

KErrNoMemory

A memory allocation failed


NewL()

static IMPORT_C CMtmGroupData *NewL(RReadStream &aStream);

Description

Creates a new CMtmGroupData and initialises it from the specified stream.

Parameters

RReadStream &aStream

Stream from which to read previously externalised CMtmGroupData

Return value

CMtmGroupData *

New initialised CMtmGroupData

Leave codes

KErrNoMemory

A memory allocation failed


~CMtmGroupData()

IMPORT_C ~CMtmGroupData();

Description

Destructor.

[Top]


Member functions


InternalizeL()

IMPORT_C void InternalizeL(RReadStream &aStream);

Description

Internalises group registration data.

Parameters

RReadStream &aStream

Stream from which to internalise object


ExternalizeL()

IMPORT_C void ExternalizeL(RWriteStream &aStream) const;

Description

Externalises group registration data.

This is the method by which registration data is written to a MTM registration data file.

Parameters

RWriteStream &aStream

Stream to which to externalise object


MtmTypeUid()

inline TUid MtmTypeUid() const;

Description

Gets the group UID.

Return value

TUid

UID that uniquely identifies the MTM group


TechnologyTypeUid()

inline TUid TechnologyTypeUid() const;

Description

Gets the technology UID.

Technology types can be used to conceptually group different MTMs (e.g. as providing Internet email).

Return value

TUid

UID that indicates the messaging technology that the MTM group implements


MtmDllInfoArray()

IMPORT_C const CMtmDllInfoArray &MtmDllInfoArray() const;

Description

Returns a constant reference to the array of MTM dll information objects owned by the CMtmGroupData.

Return value

const CMtmDllInfoArray &

A constant reference to the MTM dll info array


GetMtmRequiredCapabilities()

IMPORT_C const TCapabilitySet &GetMtmRequiredCapabilities() const;

Description

Return value

const TCapabilitySet &


operator==()

IMPORT_C TBool operator==(const CMtmGroupData &aMtmGroupData) const;

Description

Tests for equality with another CMtmGroupData object.

Parameters

const CMtmGroupData &aMtmGroupData

CMtmGroupData object with which to compare

Return value

TBool

ETrue: equal, EFalse: unequal.