MAPI Properties

Send Feedback

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

**Note   **Unlike members of COM variant arrays, every member in a MAPI multivalued property array is of the same type. Conversation ID is not implemented. (Message grouping by thread is not supported.) There is no provision in Windows Mobile-based 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 of them 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 MAPI running on the Windows Mobile Platform, such as PR_CE_TRANSPORT_NAME, PR_CE_SIGNATURE, and PR_CE_INCOMING_SERVER. There are 38 of them in total.

Remarks

Conversation ID is not implemented. (Message grouping by thread is not supported.) There is no provision in Windows Mobile-based MAPI for iterating through an item's properties. Instead, you must retrieve one property at a time.

The following table shows the set of Property ID ranges.

Property IDs for objects other than messages and recipients fall in the Property ID range from 0x3000 through 0x3FFF. The following table shows how this range is further subdivided into smaller ranges to make assigning new Property IDs easier.

Secure Property ID Range

Related Sections

• SPropValue
  Contains information on property tag types.

See Also

Messaging | MAPI Data Types | MAPI Enumerations | MAPI Functions | MAPI Interfaces | MAPI Macros | MAPI Structures

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.