Platform SDK: CDO for Windows 2000 |
The CdoEventStatus enumeration is used when implementing a transport event sink using Microsoft Collaboration Data Objects (CDO). The second argument to the various event interface methods, such as ISMTPOnArrival.OnArrival, INNTPOnPostEarly.OnPostEarly, and INNTPOnPost.OnPost, are set to this enumeration type. Event sinks signal to the event source whether to continue running subsequent sinks, or to skip all remaining sinks and return.
Name | Value | Description |
---|---|---|
cdoRunNextSink | 0 | Proceed to run the next sink. |
cdoSkipRemainingSinks | 1 | Do not notify (skip) any remaining sinks for the event (in other words, this sink has consumed the event). |
The event dispatcher processes simple Mail Transfer Protocol (SMTP) and Network News Transfer Protocol (NNTP) transport event sinks in a sequential manner. Each sink has a priority relative to the other sinks for a particular event, and the sinks are notified one at a time. The event source proceeds from the highest priority sink to the lowest. For each sink, the dispatcher checks its returned CdoEventStatus value. If the sink sets the value to cdoSkipRemainingSinks, the dispatcher does not notify any remaining sinks.