IMAP4 MTM Overview

Provides retrieval and management of email on a remote IMAP4 server

The Messaging Architecture defines a framework in which modules (MTMs) can be implemented that provide support for particular messaging protocols. A client MTM provides the API for application engines to use the protocol. The IMAP4 MTM API provides the client MTM API, plus supporting classes, for IMAP4.

The API has two key concepts: IMAP4 Client MTM, and IMAP4 service settings.

The IMAP4 Client MTM provides IMAP-specific operations, the most important of which are synchronising with a remote server, or folder on a remote server. Some generic messaging operations, such as sending messages (for which you should use SMTP), are not supported by the MTM. Extra functions are provided for obtaining and setting IMAP4 service settings.

The IMAP4 Client MTM class is CImap4ClientMtm.

Settings for IMAP4 are stored in the message store (CMsvStore) for the service entry. Encapsulation of service settings is provided by CImImap4Settings.

The helper wraps up many individual IMAP operations into a single call. A large number of options are available, which fall into the following groups:

• get mail when already connected

• connect, get mail and then disconnect

• connect, get mail and then stay online

The get mail helper class is CImImap4GetMail.