IMailRuleClient
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, or deleted by the client.
Note The IMailRuleClient interface supersedes the functionality of the deprecated SMSReadMessage function.
When to Implement
Implement IMailRuleClient if you want to process incoming SMS text messages at the client.
When to Use
Use this interface to filter incoming SMS text messages.
Methods in Vtable Order
- IUnknown methods
| IMailRuleClient methods | Description |
|---|---|
| Initialize | Initializes the mail rule client. |
| ProcessMessage | Processes incoming messages, which can be moved, modified, or deleted. |
Remarks
A mail rule client, in addition to registering as a COM object, must add the following item to the registry:
[HKEY_LOCAL_MACHINE\Software\Microsoft\Inbox\Svc\<TransportName>\Rules]
** <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, SMS is the only supported value for <TransportName>. When Messaging starts, it calls Initialize for every transport that is associated with <TransportName>.
Requirements
Smartphone: Windows Mobile 2003 and later
OS Versions: Windows CE .NET 4.2 and later
Header: cemapi.h
Library: cemapi.lib
See Also
Last updated on Friday, April 22, 2005
© 2005 Microsoft Corporation. All rights reserved.
Send feedback on this topic to the authors.