OnPostEarly Method

[This is preliminary documentation and subject to change.]

Called by the NNTP event source on bound OnPostEarly event sinks when message or news feed headers arrive to the NNTP service but before the message content has arrived.

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

Msg

An IMessage interface on a Message object holding the arrived message headers and envelope fields.

EventStatus

On return, the status of the event. The event sink signals to the source whether to continue notifying subsequent event sinks of the event, or to stop and return. The CdoEventStatus enumeration in the type library defines enumerated values for this argument.

Remarks

For OnPostEarly events, the Message object accessible to each sink contains only envelope fields and message header fields; when this event fires, the body of the message has not yet arrived. You can access the envelope fields for the message using the IMessage.EnvelopeFields collection. You can access the message headers using properties on the IMessage interface, such as IMessage.Newsgroups, or using the IMessage.Fields collection. The message headers read-only, but the envelope fields can be modified.

The OnPostEarly event for the NNTP service is synchronous, meaning that the event dispatcher thread is blocked for the duration of time required for either 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

INNTPOnPost Interface

INNTPOnPostFinal Interface

IMessage Interface

CdoEventStatus Enum