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.
The API has four key concepts: SMTP Client MTM, SMTP service settings, progress information, and email message entry information.
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.
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
.
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
.
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).