OnPostEarly Method
Topic Last Modified: 2006-06-13
Called by the Network News Transfer Protocol (NNTP) event source on bound OnPostEarly event sinks when message or news feed headers arrive to the NNTP service before the message content has arrived.
Applies To
Type Library
Microsoft CDO for Exchange 2000 Library
DLL Implemented In
CDOEX.DLL
Syntax
Sub OnPostEarly( ByVal Msg As CDO.Message,
EventStatus As CdoEventStatus)
HRESULT OnPostEarly
(
IMessage* Msg,
CdoEventStatus* EventStatus
);
Parameters
- Msg
An IMessage interface on a Message object holding the message headers and envelope fields that arrived.
- 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 Enum in the type library defines enumerated values for this argument.
Return Value
Returns S_OK if successful, or an error value otherwise.
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 are 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 either for the duration of time required 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.