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.