MAPI Properties

  • Article

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.
  • 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.

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

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