Platform SDK: SMTP Server Events

IMailTransportSubmission::OnMessageSubmission

[This is preliminary documentation and subject to change.]

Called by an SMTP event source when a message has been submitted to the queue.

[local]
HRESULT OnMessageSubmission(
   [in] IMailMsgProperties     *pIMailMsg,
   [in] IMailTransportNotify   *pINotify,
   [in] PVOID                   pvNotifyContext
);
pIMailMsg
A reference to the MailMsg object housing the submitted message.
pINotify
A callback reference used to notify the source that asynchronous processing has completed.
pvNotifyContext
The context in which the sink is executing. This reference can be used during sink execution and is subsequently returned through IMailTransportNotify::Notify if the sink is running asynchronously with respect to the calling source.

Return Values

Value Description
S_OK Success. The operation completed synchronously.
S_FALSE Success. The operation will execute asynchronously with respect to the calling source thread.