Collapse all Symbian^3 Application Developer Library

MProtocolImConversationDataHost Class Reference

class MProtocolImConversationDataHost : public MXIMPBase

Interface for managing cached conversation information.

Interface is used by protocol adaptations to manage conversation information stored in IM internal data cache.

This interface is implemented by IM. Protocol adaptation can obtain reference to this interface from MXIMPProtocolConnectionHost interface.

For each separated protocol connection, protocol adaptation must use the specific MImProtocolConversationDataHost instance, what is received from the connection specific MXIMPProtocolConnectionHost instance.

Since: S60

Inherits from

MProtocolImConversationDataHost
- MXIMPBase

Public Member Functions
TXIMPRequestId	HandleNewTextMessageL ( MImConversationInfo *)

Protected Member Functions
	~MProtocolImConversationDataHost ()

Constructor & Destructor Documentation

~MProtocolImConversationDataHost()

~MProtocolImConversationDataHost

(

)

[protected, inline, virtual]

Protected destructor. Object instancies can't be deleted via this interface.

Member Functions Documentation

HandleNewTextMessageL(MImConversationInfo *)

TXIMPRequestId

HandleNewTextMessageL

(

MImConversationInfo *

aImMessage

)

[pure virtual]

Notifies IM from message sent completion information.

Protocol adaptation implementation can call this method to notify IM from message sent completion information. IM updates its cached information and notifies the subscribing clients from data changes.

IM takes ownership of the argument(s), if method succeeds without a leave.

leave: KErrNoMemory if failed to allocate memory.

leave: KErrArgument if NULL argument(s) were provided. Notifies IM from new text message received information.

Protocol adaptation implementation can call this method to notify IM from new text message received information. IM updates its cached new text message and notifies the subscribing clients from data changes.

IM takes ownership of the argument(s), if method succeeds without a leave.

leave: KErrNoMemory if failed to allocate memory.

leave: KErrArgument if NULL argument(s) were provided.

Parameters

MImConversationInfo * aImMessage