Send-As Messaging

Messaging provides a simple-to-use interface that allows applications to package data into outgoing messages. The class CSendAs provides client applications with the means to:

• get a list of the names of the MTMs that have the required capabilities

• get a list of the services that can be used with the chosen MTM

• create a message and define the body and/or attachments for that message, without forcing the client application to launch any message-specific user interface

• validate any part of the message and store it, so it is ready for sending from the device next time it is connected to the appropriate service

An application using this determines first that an appropriate MTM is available by setting the required capabilities, such as whether attachments are supported or whether the message body is restricted to plain text, and then obtaining the names of the available MTMs. Alternatively, if the caller knows which MTM to use, it can be set directly using the MTM UID.

If there is more than one service that can be used by the MTM, for example, more than one SMTP account, then the caller can chose which one to use. If the caller does not set a service, then the default service is used.