Automatic Message Property Promotion

Automatic Message Property Promotion

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

The Exchange store automatically sets properties for messaging items when the associated stream is saved. You control this behavior through the file name extension of the item. When you create an item with an .eml extension, and write the item's stream, the Exchange store assumes that the stream is formatted according to the RFC 822 and Multipurpose Internet Mail Extensions (MIME) standards. It examines the inbound stream for various messaging-related values, such as mail header fields and message text, and automatically sets these properties for the item. This is referred to as property promotion; the promotion is from data within the stream to properties for the item. The Exchange store checks the stream for all properties defined by the urn:content-classes:message content class for promotion.

In the following example, you create an item in your inbox with the name mymessage.eml and you also save and commit the following stream to the item in the Exchange store:

To: "User 1" <user1@example.com>
From: "User 2" <user2@example.com>
Subject: My latest draft.

This is the text portion of the message.

The following table lists the properties for the items after saving the stream.

Note  The Exchange store does not automatically update the stream for the message when the properties are changed using OLE DB or Microsoft® ActiveX® Data Objects (ADO). You must update the stream separately. To avoid updating the stream separately, use the Collaboration Data Objects (CDO) Message object or the CalendarMessage object when you modify existing items in the Exchange store. These objects automatically ensure that messaging properties and the item stream remain synchronized.

Send us your feedback about the Microsoft Exchange Server 2003 SDK.

Build: June 2007 (2007.618.1)

© 2003-2006 Microsoft Corporation. All rights reserved. Terms of use.