Server MTMs provide specific message type storage and transport. It interacts with the Messaging Server to store and manage entries and provide a transport mechanism, using components such as the Telephony Server or Sockets Server, to send and receive messages. When a message is received, the Server MTM creates a new index entry and stores the message data in the entry’s store and binary files. Conversely, when a message is sent, the Server MTM retrieves the message data from the index, and converts the message into a format appropriate for the message transport.
Server MTMs must provide the following capabilities:
Copy and move files to or from the local folders
Return the progress of the current operation
Interpret MTM-specific commands
Note: Some Server MTMs may also have the ability to create, delete, and change messages and folders on remote servers.
The base class for Server MTM is CBaseServerMtm .
Note: Developers of Messaging client applications must not be concerned with this class and its sub-classes, as these are accessed only by the Message Server.
Server MTM functions are called by the Message Server as a result of a client request that requires some remote operation with the MTM's protocol. The following are some significant functions that can be implemented in a class derived from the CBaseServerMtm base class:
Copy and move from remote functions
The CBaseServerMtm::CopyToLocalL() and CBaseServerMtm::MoveToLocalL() functions are called by the Message Server to get a selection of entries from a remote location. For many protocols, this must be interpreted as message retrieval. For protocols where messages exist on a remote server, this function is typically used to download specific messages, after an initial connection has downloaded message headers.
Copy and move to remote functions
The CBaseServerMtm::CopyFromLocalL() and CBaseServerMtm::MoveFromLocalL() functions are called by the Message Server to copy or move a selection of entries to a remote location. For many protocols, this must be interpreted as message sending.
Copy and move within remote functions
The CBaseServerMtm class provides the virtual functions for overriding in derived classes.
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License v1.0.