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.
4/8/2010

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.

Note:
Messaging rules clients are supported for Short Message Service (SMS) text messages only.

Multiple messaging rules clients can be registered to process messages for a particular message store. In this scenario, there is no way to make sure that an arriving message is processed by messaging rules clients in any specific order (making sure that one messaging rules client sees the message before another).

A custom messaging rules client is a DLL that contains message filtering criteria and a message processing rule. It also supports the IMailRuleClientinterface.

To become active, a messaging rules client DLL must be registered with Windows Embedded CE twice. The first entry registers the messaging rules client as a COM server and uses the following registry key: HKEY_CLASSES_ROOT\CLSID\{GUID}\InProcServer32. The second entry registers the messaging rules client as a service with the Messaging application and uses the following registry key: HKEY_LOCAL_MACHINE\Software\Microsoft\Inbox\Svc\SMS\Rules.

Note:
To respond to changes in the registry, the Messaging application must be restarted after the registry has been updated.

When a custom messaging rules client is active, the following occurs when a new Short Message Service (SMS) message arrives:

  1. The Messaging application searches the registry for messaging rules clients that are registered for this particular message store.

  2. The Messaging application activates the messaging rules client DLL.

  3. If the message is the first message on this transport, the Messaging application calls IMailRuleClient::Initialize.

  4. After the messaging rules client is initialized, the Messaging application calls IMailRuleClient::ProcessMessagefor the message and for all subsequent messages as they arrive.

For more information, see How to: Register Customized Messaging Rules Clients.

See Also