IMAPISupport::DoSentMail

The IMAPISupport::DoSentMail method performs processing on a sent message.

Quick Info

See IMAPISupport : IUnknown.

HRESULT DoSentMail(
  ULONG ulFlags,       
  LPMESSAGE lpMessage  
);
 

Parameters

ulFlags

Reserved; must be zero.

lpMessage

[in] Pointer to the open message for which a message should be generated in the folder designated to hold sent items.

Return Values

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 within their implementation of the IMsgStore::FinishedMsg method, called by the MAPI spooler when it has finished processing a message. FinishedMsg unlocks the message, ensures that the message's reference count is one, and calls IMAPISupport::DoSentMail.

DoSentMail performs the following tasks:

• Determines whether the message should be deleted after sending by checking the message for the PR_DELETE_AFTER_SUBMIT property.
• 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 as specified by any messaging hook providers.
• Releases the message.

See Also

IMsgStore::FinishedMsg