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.
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 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 Short Message Service (SMS) message arrives:
- The Messaging application searches the registry for messaging rules clients that are registered for this particular message store.
- The Messaging application activates the messaging rules client DLL.
- If the message is the first message on this transport, the Messaging application calls IMailRuleClient::Initialize.
- 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