Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
MSDN Library
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.


Windows Mobile 6.5

The IMailRuleClient interface allows you to implement a Mail Rule Client that can process incoming messages. Currently, only Short Message Service (SMS) text messages can be processed. Processed messages can be moved, modified, and deleted by the client.

The IMailRuleClient interface supersedes the functionality of the deprecated SmsReadMessage function.

Implement IMailRuleClient when you want to process incoming Short Message Service (SMS) text messages at the client.

Use this interface to filter incoming Short Message Service (SMS) text messages.

IMailRuleClient methods Description


Initializes the mail rule client.


Processes incoming messages, which can be moved, modified, or deleted.

A mail rule client, in addition to registering as a COM object, must add the following item to the registry:

<CLSID> = dword: 1

Replace <CLSID> with the class identifier (CLSID) of the mail rule client, and replace <TransportName> with the transport name that the rule client is registering for. Currently, Short Message Service (SMS) is the only supported value for <TransportName>. When Messaging starts, it calls Initialize for every transport that is associated with <TransportName>.

The MAPI Rules sample requires privileged access.

Windows Embedded CEWindows CE .NET 4.2 and later
Windows MobilePocket PC for Windows Mobile 2003 and later, Smartphone for Windows Mobile 2003 and later

Community Additions

© 2015 Microsoft