Platform SDK: MAPI

PR_TNEF_CORRELATION_KEY

The PR_TNEF_CORRELATION_KEY property contains a value used to correlate a TNEF attachment with a message.

Quick Info

Header file: MAPITAGS.H
May be exposed by: TNEF attachment subobjects
Identifier: 0x007F
Property type: PT_BINARY
Property tag: 0x007F0102

Remarks

It is recommended that TNEF attachment subobjects expose the PR_TNEF_CORRELATION_KEY 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 PR_TNEF_CORRELATION_KEY 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 PR_TNEF_CORRELATION_KEY 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 PR_TNEF_CORRELATION_KEY is not set, the TNEF file should be considered to belong to this message, and the other properties extracted from it should be used.

See Also

Attachment Properties