Rules Client Custom Form

Send Feedback

This code sample is named CustomForm. It demonstrates how to implement a mail rule client to capture and process Short Messaging Service (SMS) and Enhanced Messaging Service (EMS) messages, process multipart EMS messages, and implement a custom read-form to display these messages in the Messaging application.

Feature Area

• Messaging
• Networking and Communication
• Pocket Outlook Object Model (POOM)

Relevant APIs

• Messaging API (MAPI) API
• IFormProviderEx interface
• IMailRuleClient interface
• MRCHANDLED enumeration

Usage

To run the code sample

1. Navigate to one of the solution files (*.sln), and double-click it. By default, the solution files are copied to the following folders:

   C:\Program Files\Windows CE Tools\wce500\Windows Mobile 5.0 Pocket PC SDK\Samples\CPP\Win32\Customform\``CustomForm.sln

   C:\Program Files\Windows CE Tools\wce500\Windows Mobile 5.0 Pocket PC SDK\Samples\CPP\Win32\Customform\Emscustomform\``EMSCustomForm.sln

   C:\Program Files\Windows CE Tools\wce500\Windows Mobile 5.0 Pocket PC SDK\Samples\CPP\Win32\Customform\Emsruleclient\``EMSRuleClient.sln

   C:\Program Files\Windows CE Tools\wce500\Windows Mobile 5.0 Smartphone SDK\Samples\CPP\Win32\Customform\``CustomForm.sln

   C:\Program Files\Windows CE Tools\wce500\Windows Mobile 5.0 Smartphone SDK\Samples\CPP\Win32\Customform\Emscustomform\``EMSCustomForm.sln

   C:\Program Files\Windows CE Tools\wce500\Windows Mobile 5.0 Smartphone SDK\Samples\CPP\Win32\Customform\Emsruleclient\``EMSRuleClient.sln

   Microsoft Visual Studio 2005 launches and loads the solution.

2. Build the solution (Ctrl+Shift+B).

3. Deploy the solution (F5).

To use the application

1. Install the application on the mobile device by copying the file CustomFormSetup.cab to the mobile device, and running it on the mobile device.
2. Reboot the mobile device.
3. Once the Rule Client and Custom Form are installed, you should be able to receive EMS messages on the mobile device. They will be processed by the Rule Client, and available for viewing in the SMS account in Inbox. The only supported EMS Information Element Identifiers (IEIs) are pictures. Generic SMS data (text) is also processed.

Remarks

It is assumed that the mobile device supports SMS messaging.

Supported IEIs are those referenced from 3GPP TS 23.040, V4.3.0.

Additional IEIs will be ignored by the Rule Client.

• 0x10 = Large Picture (32x32)
• 0x11 = Small Picture (16x16)
• 0x12 = Variable Size Picture

Requirements

Pocket PC SDK: Windows Mobile 5.0 Pocket PC SDK.
Smartphone SDK: Windows Mobile 5.0 Smartphone SDK.
Development Environment: Visual Studio 2005.
ActiveSync: Version 4.0.

See Also

Code Samples | Messaging Overview | Customized Messaging Rules Clients | Messaging Forms | MAPI Rules | New Message Class | Message Stores | IMsgStore

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.