Platform SDK: SMTP Server Events

IMailTransportOnPostCategorize::OnMessagePostCategorize

[This is preliminary documentation and subject to change.]

The IMailTransportOnPostCategorize::OnMessagePostCategorize method is called by an SMTP event source after the categorizer has finished categorizing a MailMsg object. Sinks registered for the SMTP OnPostCategorize (CATID_SMTP_TRANSPORT_POSTCATEGORIZE) event are notified.

[local]
HRESULT OnMessagePostCategorize(
   [in] IMailMsgProperties     *pIMailMsg,
   [in] IMailTransportNotify   *pINotify,
   [in] PVOID                   pvNotifyContext
);
pIMailMsg
A reference to the MailMsg object housing the 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.

Remarks

This event method corresponds to sinks registered as subscribers to the SMTP OnPostCategorize event. The corresponding COM Category ID is CATID_SMTP_TRANSPORT_POSTCATEGORIZE.

See Also

IMailMsgProperties Interface