PidTagTnefCorrelationKey Canonical Property

Applies to: Outlook 2013 | Outlook 2016

Contains a value that correlates a Transport Neutral Encapsulation Format (TNEF) attachment with a message.

Property Value
Associated properties:
PR_TNEF_CORRELATION_KEY
Identifier:
0x007F
Data type:
PT_BINARY
Area:
MAPI envelope

Remarks

It is recommended that TNEF attachment sub-objects expose this property. This property determines whether or not an inbound TNEF file belongs to the message it is attached to. It is used primarily by transport providers and gateways.

On an outbound message, the transport provider should compute a binary value unique to that message, or use an existing value that satisfies the uniqueness requirement, such as a message identifier. The transport provider should store this value in this property and then call the ITnef::AddProps method to encapsulate it. The same value should also be stored in the transport envelope in a place defined by the provider, such as the message header.

On an inbound message, the transport provider should call the ITnef::ExtractProps method to decapsulate the TNEF attachment and then compare this property with the value stored in the transport envelope. If the values match, TNEF should be processed normally, that is, all the properties extracted from the TNEF attachment should be used. If the values do not match, all the properties from the TNEF attachment should be ignored. If this property is not set, the TNEF file should be considered to belong to this message, and the other properties extracted from it should be used.

Protocol specifications

[MS-OXPROPS]

Provides references to related Exchange Server protocol specifications.

[MS-OXCFXICS]

Handles the order and flow for data transfers between a client and server.

[MS-OXCMAIL]

Converts from Internet standard email conventions to message objects.

[MS-OXTNEF]

Encodes and decodes message and attachment objects to an efficient stream representation.

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