|Important||This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here.|
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.
Creates a new message.
You can choose whether to set all of the required message properties in CreateMessage or in the message's IMAPIProp::SaveChanges method. You do not have to make these properties available until a successful save has occurred.
Some message store providers allow the entry identifier of the new message to be available immediately after CreateMessage returns; others delay its availability until the message has been saved. Because not all message store providers generate an entry identifier for a new message until you have called the message's IMAPIProp::SaveChanges method, you may not be able to access the entry identifier when CreateMessage returns. Also, the new message may not be included in the folder's contents table until the save occurs.
Expect the entry identifier assigned to the new message to be unique not only in the current message store, but most likely across all of the message stores that are open concurrently. One exception to this rule occurs when multiple entries for a message store appear in the profile, which causes the message store to be opened multiple times and entry identifiers to be duplicated.
To create an outgoing message, call the Outbox folder's IMAPIFolder::CreateMessage method.
If you delete a folder that contains a new message before the message is saved, the results are undefined.