PidTagConversationIndex Canonical Property

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

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

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 e-mail message objects.

Header Files

  • Mapidefs.h
    Provides data type definitions.

  • Mapitags.h
    Contains definitions of properties listed as alternate names.

See Also

Concepts

MAPI Properties

MAPI Canonical Properties

Mapping Canonical Property Names to MAPI Names

Mapping MAPI Names to Canonical Property Names