Symbian Developer Library

SYMBIAN OS V6.1 EDITION FOR C++

[Index] [Glossary] [Previous] [Next]



SMTP MTM Overview


Purpose

Provides sending of Internet email messages.

[Top]


Architectural relationships

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 SMTP API provides the client MTM API, plus supporting classes, for SMTP.

[Top]


Description

The API has four key concepts: SMTP Client MTM, SMTP service settings, progress information, and email message entry information.


SMTP Client MTM

The SMTP Client MTM provides an SMTP-specific operation, to enable automatic sending of waiting messages either immediately or whenever a dial-up connection is made. Some generic messaging operations, such as receiving messages, are not supported by the MTM.

The SMTP Client MTM class is CSmtpClientMtm.


SMTP service settings

Settings for SMTP connections are stored in the message store (CMsvStore) for the SMTP service entry. Settings include server address and email address. Encapsulation of service settings is provided by CImSmtpSettings.


Progress information

The Messaging Architecture allows progress information to be obtained for messaging operations. For SMTP operations, progress information includes such things as connection state and number of messages sent. Progress information is provided by TSmtpProgress.


Email message entry information

Protocol-specific data for a message is stored in fields in its index entry. A class TMsvEmailEntry is provided to read these fields for e-mail protocols (including SMTP).