Rules Client Custom Form
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
8/28/2008
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
Relevant APIs
- Messaging API (MAPI) API
- IFormProviderEx interface
- IMailRuleClient interface
- MRCHANDLED enumeration
Usage
To run the code sample
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 Mobile 6 SDK\Samples\Common\CPP\Win32\CustomFormMicrosoft Visual Studio 2005 launches and loads the solution.
Build the solution (Ctrl+Shift+B).
Deploy the solution (F5).
To use the application
Install the application on the mobile device by copying the file CustomFormSetup.cab to the mobile device, and running it on the mobile device.
Reboot the mobile device.
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
Development Environments
SDK: Windows Mobile 6 Professional SDK and Windows Mobile 6 Standard SDK
Development Environment: Visual Studio 2005.
ActiveSync: Version 4.5.
See Also
Concepts
Code Samples for Windows Mobile
MAPI Rules
New Message Class
Other Resources
Messaging Application Development
Customized Messaging Rules Clients
Messaging Forms
Message Stores
IMsgStore