IMailTransportOnPreCategorize::OnSyncMessagePreCategorize

[This is preliminary documentation and subject to change.]

The IMailTransportOnPrecategorize::OnSyncMessagePreCategorize method is called by an SMTP event dispatcher to notify sinks of the OnPreCategorize event.

[local]
HRESULT OnSyncMessagePreCategorize(
   [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

Remarks

The OnPreCategorize event is fired after the OnTransportSubmission event to indicate that the message is about to be submitted to the categorizer. The difference between these two events is semantic: it is assumed that OnPreCategorize event sinks will not perform any type of additional re-mapping or expansion of the recipient list.

This event method corresponds to sinks registered as subscribers to the SMTP OnPreCategorize event. The corresponding COM Category ID is CATID_SMTP_TRANSPORT_PRECATEGORIZE. The string version of the GUID is "{A3ACFB0D-83FF-11d2-9E14-00C04FA322BA}".

See Also

IMailMsgProperties Interface