Set Message Store Properties

8/28/2008

This code sample is named Mailset. It demonstrates how to retrieve and set properties on a message store. The application reads the contents of an XML file named mailset.xml, which contains a list of MAPI properties (for example, PR_CE_AGE_FILTER, PR_CE_INCOMING_SERVER, and PR_CE_DOMAIN) that you can change.

Feature Area

• Messaging

Relevant APIs

• Messaging API (MAPI) API
• IMAPISession interface
• IMAPITable interface
• IMAPIProp::GetProps method
• IMAPIProp::SetProps method

Usage

To run the code sample

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

   C:\Program Files\Windows Mobile 6 SDK\Samples\PocketPC\CPP\win32\MailSet

   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. Copy the XML file mailset.xml and the executable file "MailSet.exe" to the same directory on the mobile device.

2. Execute "MailSet.exe".

Remarks

You have at least one message account (SMS, ActiveSync) set up.

The XML document has the following format:

<store proptag="0x811A000B"  propname="PR_CE_USE_SIGNATURE"  display="Use the account signature"  default="0"  type="2"/>

where:

• proptag
  The numeric value of the property.

• propname
  The name of this property.

• display
  A friendly description of this property.

• default
  The default value of this property to use if it is not in the store.

• type
  The type of the property, where:

  0 = String

  1 = Integer

  2 = Boolean

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

Other Resources

MAPI Properties
Windows Mobile Defined MAPI Properties