Share via

IMailRuleClient (Compact 7)

  • Article

3/12/2014

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, and deleted by the client.

Note

The IMailRuleClient interface supersedes the functionality of the deprecated SmsReadMessage function.

When to Implement

Implement IMailRuleClient when you want to process incoming Short Message Service (SMS) text messages at the client.

When to Use

Use this interface to filter incoming Short Message Service (SMS) text messages.

Methods in Vtable Order

IMailRuleClient methods Description

IMailRuleClient::Initialize

Initializes the mail rule client.

IMailRuleClient::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, Short Message Service (SMS) is the only supported value for <TransportName>. When Messaging starts, it calls Initialize for every transport that is associated with <TransportName>.

Requirements

Header

cemapi.h

Library

cemapi.lib

See Also

Reference

MAPI Interfaces