PidTagConversationIndex Canonical Property

Applies to: Outlook 2013 | Outlook 2016

Contains a binary value that indicates the relative position of this message within a conversation thread.

Property Value
Associated properties:
PR_CONVERSATION_INDEX
Identifier:
0x0071
Data type:
PT_BINARY
Area:
General messaging

Remarks

A conversation thread represents a series of messages and replies. This property is usually implemented using concatenated time stamp values. Its use is optional, even if PR_CONVERSATION_TOPIC (PidTagConversationTopic) is set.

MAPI provides the ScCreateConversationIndex function to create or update a conversation index. The function takes the current index value as a counted byte array and returns the index value with a time stamp concatenated onto the end. A message representing a reply to another message should use ScCreateConversationIndex to update this property.

A message store provider has the option of assuring that PR_CONVERSATION_INDEX is always set on incoming or outgoing messages. It can do this by calling ScCreateConversationIndex, either with the existing value if this property is set or with NULL if it is not. This action should be taken before IMAPIProp::SaveChanges is called.

All messages that have the same value for PR_CONVERSATION_TOPIC can be sorted on this property to reveal the hierarchical relationship of the messages.

Protocol specifications

[MS-OXPROPS]

Provides references to related Exchange Server protocol specifications.

[MS-OXOMSG]

Specifies the properties and operations that are permissible on email message objects.

Header files

Mapidefs.h

Provides data type definitions.

Mapitags.h

Contains definitions of properties listed as alternate names.

See also

MAPI Properties

MAPI Canonical Properties

Mapping Canonical Property Names to MAPI Names

Mapping MAPI Names to Canonical Property Names