Platform SDK: CDO for Windows 2000

OnPost Method

The OnPost method is called by the NNTP event source on bound OnPost event sinks when a message has arrived to the NNTP service.

[Visual Basic]
Sub OnPost(ByVal Msg as CDO.Message, EventStatus as CdoEventStatus)
[C++]
HRESULT OnPost(IMessage* Msg, CdoEventStatus* EventStatus);
[IDL]
HRESULT OnPost([in] IMessage* Msg, [in,out] CdoEventStatus* EventStatus);

Parameters

Msg
An IMessage interface on a Message object that is holding the arrived message.
EventStatus
On return, the EventStatus parameter indicates the status of the event. The event sink signals to the dispatcher whether to continue notifying subsequent event sinks of the event, or to stop and return. The CdoEventStatus enumeration contains the possible values for this parameter.

Remarks

The Message object contains the message in unexpanded format; the recipient addresses have not been resolved or expanded, and as such, are still in the format in which the sending agent placed them in the message envelope. The sink cannot modify the contents of the posted message. The envelope fields, however, can be modified. For more information, see SMTP/NNTP Transport Event Sinks with CDO.

The OnPost event for the NNTP service is synchronous, which means that the event dispatcher thread is blocked for the duration of time necessary for all bound event sinks to be created (if necessary) and executed, or until a sink preemptively stops event notifications by returning the EventStatus parameter with the value cdoSkipRemainingSinks.

See Also

SMTP/NNTP Transport Event Sinks with CDO

INNTPOnPostEarly Interface

INNTPOnPostFinal Interface