MAPI Properties

4/8/2010

This section contains property tag definitions for standard properties of Windows Mobile Messaging API (CE MAPI) objects. Each property has an associated hexadecimal Property Identifier (ID). Properties in similar categories are grouped together into ranges of Property IDs.

Note

Unlike members of COM variant arrays, every member in a MAPI multi-valued property array is of the same type. Conversation ID is not implemented. Message grouping by thread is not supported. There is no provision in CE MAPI for iterating through an item's properties. Instead, you must retrieve one property at a time.

In This Section

The following subsections correspond to each of the property types, and are listed according to their position in the range of Property IDs. See the remarks section for more information.

• Message Envelope Properties
  Message object properties such as PR_MESSAGE_CLASS, PR_SUBJECT, and PR_CONVERSATION_TOPIC. There are 189 message envelope properties in total.

• Message Content Properties
  Message content properties such as PR_BODY, PR_REPORT_TEXT, and PR_RTF_COMPRESSED. There are 18 of them in total.

• Message Recipient Properties
  Message recipient properties such as PR_SENDER_NAME, PR_SENDER_EMAIL_ADDRESS, and PR_NON_RECEIPT_NOTIFICATION_REQUESTED. There are 42 of them in total.

• Non-Transmittable Message Properties
  Non-transmittable message object properties such as PR_DELETE_AFTER_SUBMIT, PR_DISPLAY_BCC, and PR_MESSAGE_DELIVERY_TIME. There are 45 of them in total.

• Common Non-Transmittable Properties
  Non-transmittable properties that never appear on message objects., such as PR_ENTRYID, PR_OBJECT_TYPE, and PR_ICON. There are 12 of them in total.

• Common Transmittable Properties
  Transmittable properties that never appear on message objects., such as PR_DISPLAY_NAME, PR_EMAIL_ADDRESS, and PR_CREATION_TIME. There are 26 of them in total.

• MAPI Form Properties
  Properties that appear on message form objects, such as PR_FORM_VERSION, PR_FORM_CLSID, and PR_FORM_MESSAGE_BEHAVIOR. There are 20 of them in total.

• Message Store Properties
  Properties that appear on message store objects, such as PR_DEFAULT_STORE, PR_STORE_STATE, and PR_MDB_PROVIDER. There are 17 of them in total.

• Folder and Address Book Container Properties
  Properties that appear on folder and address book container objects, such as PR_FOLDER_TYPE, PR_CONTENT_COUNT, and PR_AB_PROVIDER_ID. There are 26 of them in total.

• Attachment Properties
  Properties that appear on attachment objects, such as PR_ATTACH_EXTENSION, PR_ATTACH_FILENAME, and PR_ATTACH_ADDITIONAL_INFO. There are 30 of them in total.

• Address Book Properties
  Properties that appear on address book objects, such as PR_DISPLAY_TYPE, PR_TEMPLATEID, and PR_PRIMARY_CAPABILITY. There are 3 of them in total.

• Mail User Properties
  Recipient properties such as PR_GIVEN_NAME, PR_STREET_ADDRESS, and PR_CONTACT_EMAIL_ADDRESSES. There are 261 of them in total.

• User Profile Properties
  Account profile properties such as PR_PROFILE_NAME, PR_DEFAULT_PROFILE, and PR_SERVICES. There are 28 of them in total.

• Status Object Properties
  Session resource properties such as PR_STATUS_CODE, PR_STATUS_STRING, and PR_RESOURCE_METHODS. There are 22 of them in total.

• Display Table Properties
  Display table properties such as PR_CONTROL_TYPE, PR_CONTROL_ID, and PR_XPOS. There are 9 of them in total.

• Windows Mobile Defined MAPI Properties
  Custom properties defined for CE MAPI, such as PR_CE_TRANSPORT_NAME, PR_CE_SIGNATURE, and PR_CE_INCOMING_SERVER. There are 38 of them in total.

Property ID ranges

The following table shows the Property ID ranges in which properties in similar categories are grouped.

From	To	Category
0000		Reserved by MAPI for the special value PR_NULL.
0001	0BFF	Message envelope properties defined by MAPI.
0C00	0DFF	Recipient properties defined by MAPI.
0E00	0FFF	Non-transmittable message properties defined by MAPI.
1000	2FFF	Message content properties defined by MAPI.
3000	3FFF	Properties for objects other than messages and recipients defined by MAPI. See the table below for more details.
4000	57FF	Message envelope properties defined by Transport Providers.
5800	5FFF	Recipient properties defined by Transport and Address Book Providers.
6000	65FF	Non-transmittable message properties defined by Clients.
6600	67FF	Non-transmittable properties defined by a Service Provider. These properties can be visible or invisible to users.
6800	7BFF	Message content properties for custom message classes defined by creators of those classes.
7C00	7FFF	Non-transmittable properties for custom message classes defined by creators of those classes.
8000	FFFE	Properties defined by clients, and occasionally service providers that are identified by name through the IMAPIProp::GetIDsFromNames method.

Property IDs for Objects other than Messages and Recipients

The following table shows how this particular range is further subdivided into smaller ranges, to make assigning new Property IDs easier.

From	To	Category
3000	32FF	Common properties that appear on multiple objects, such as PR_DISPLAY_NAME and PR_ENTRYID.
3200	33FF	Form properties.
3400	35FF	Message Store properties.
3600	36FF	Folder and Address Book Container properties.
3700	38FF	Attachment properties.
3900	39FF	Address Book properties.
3A00	3BFF	Messaging User properties.
3C00	3CFF	Distribution List properties.
3D00	3DFF	Profile properties.
3E00	3FFF	Status object properties.

Secure Property ID Range

Constant	Property ID
PROP_ID_SECURE_MIN	0x67F0
PROP_ID_SECURE_MAX	0x67FF

Related Sections

• MAPI Property Data Types
  Contains information on property tag types.

Remarks

Conversation ID is not implemented (message grouping by thread is not supported).

There is no provision in CE MAPI for iterating through an item's properties. Instead, you must retrieve one property at a time.

See Also

Reference

MAPI Data Types
MAPI Enumerations
MAPI Functions
MAPI Macros
MAPI Structures

Other Resources

Messaging API (CE MAPI) Reference
Messaging
MAPI Interfaces