Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Information
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.

Customized Messaging Rules Clients

Windows Mobile 6.5
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.

Bb159884.note(en-us,MSDN.10).gifNote:
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 IMailRuleClient interface.

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.

Bb159884.note(en-us,MSDN.10).gifNote:
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::ProcessMessage for the message and for all subsequent messages as they arrive.

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

Community Additions

Show:
© 2015 Microsoft