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

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