Important: |
---|
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
MAPI is a COM-based library that provides programmatic access to the Microsoft messaging client application, Messaging (formerly named Inbox), as well as to message stores and the message items they contain.
You can also use MAPI to create an entirely new messaging client application, create a new messaging transport, create custom forms for the Messaging application, implement a mail-rule client to programmatically process incoming messages, implement an advise-sink object for handling notifications, and programmatically manage high-level operations on container objects like address books, distribution lists, and folders.
Note: |
---|
Prior to the release of Pocket PC 2002 and Smartphone 2002 software, programmatic access to the messaging system was provided through the Windows Embedded CE MsgStore APIs (found in msgstore.h and msgstore.lib). Although later versions of Windows Mobile provide limited backward compatibility, it is recommended that you modify your code to use MAPI instead. |
In This Section
For background information on the messaging subsystem, and on extending the Messaging application, see the following topics in this section:
- Customized Messaging Rules Clients
-
A customized messaging rules client is a message processor that works in conjunction with the Messaging application (or any other messaging client application). When a message arrives at a particular message store, the messaging rules client checks to see whether it meets a set of criteria (defined by the messaging rules client). If it does, the client moves the message to a destination folder, modifies it, or deletes it. For example, a messaging rules client can delete incoming messages that are sent from a list of blocked senders.
- Hyperlinking in Messages
-
The Windows Mobile Messaging application recognizes web address and other URI monikers in SMS and e-mail messages and automatically presents them to users as clickable hyperlinks in the read form. It is a feature called Smart Hyperlinking, and it provides users with the convenience of being able to act on message content to open web pages, open files, begin e-mail and SMS message composition, and place telephone calls.
- Message Stores
-
A message store serves as a local archive for storing messages on Windows ®phones. One message store is present for each messaging account, and each messaging account is associated with one message transport. For example, you might use a Windows phone to service three POP3 e-mail accounts. In this scenario, you might have four message stores: one for Outlook e-mail transferred through ActiveSync, two for Outlook e-mail transferred via POP3, and one for text messages transferred via Short Message Service (SMS).
- Messaging Forms
-
You can change the behavior of the Messaging application (or any other messaging client application) by creating customized messaging forms. They are customized read and compose forms and can be used with new and existing transports. The behavior that they provide can vary, from adding new transport types such as Multimedia Messaging Service (MMS) to adding a new message type, such as one that supports playing a game like ticktacktoe.
- Messaging Transports
-
A message transport is a networking protocol that facilitates the transfer of messages between a messaging client application and a messaging host server.
- SMS Messaging
-
The Messaging Application treats SMS messages just like e-mail messages—receiving them in a separate messaging account. All GSM codes are supported, including the ability to replace old SMS messages with new ones. Long SMS messages are parsed appropriately into several messages sent in succession to the recipient SMS user. SMS messages can be forwarded, replied to, created, and saved, just like e-mail.
- Over the Air Provisioning with SI and SL Messages
-
SI and SL messages are part of a WAP Push mechanism that mobile operators can use to provision files over the air (OTA) to Windows Mobile devices.