IMAPISupport::DoSentMail
Applies to: Office 2010 | Outlook 2010 | Visual Studio
Processes a sent message.
HRESULT DoSentMail(
ULONG ulFlags,
LPMESSAGE lpMessage
);
Parameters
ulFlags
[in] Reserved; must be zero.lpMessage
[in] A pointer to the open message for which a message should be generated in the folder designated to hold sent items.
Return Value
- S_OK
The call succeeded and has returned the expected value or values.
Remarks
The IMAPISupport::DoSentMail method is implemented for message store provider support objects. Message store providers call DoSentMail from their implementation of the IMsgStore::FinishedMsg method, which is called by the MAPI spooler when it has finished processing a message. FinishedMsg unlocks the message, ensures that the message's reference count is 1, and calls DoSentMail.
DoSentMail performs the following tasks:
Checks the message for the PR_DELETE_AFTER_SUBMIT (PidTagDeleteAfterSubmit) property to determine whether the message should be deleted after sending.
Determines the location of the Sent Items folder.
Initiates message hook processing for any hooks set on the Sent Items folder.
Moves the message to the Sent Items folder, Deleted Items folder, or to another folder.
Releases the message.