Customized Messaging Rules Clients

  • Article

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 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 must also support the IMailRuleClient interface.

To become active, a messaging rules client DLL must be registered with Windows 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 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::ProcessMessage for the message and for all subsequent messages as they arrive.

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

See Also

Messaging

Messaging Transports

Messaging Forms

Message Stores

How to: Register Customized Messaging Rules Clients

Messaging Sample Code

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.