| Platform SDK: SMTP Server Events |
[This is preliminary documentation and subject to change.]
The following constants are used to set or examine a MailMsg object's IMMPID_MP_MESSAGE_STATUS property. These values only apply to message submitted to the SMTP service through the SMTP protocol or the local SMTP service pickup directory.
| Contant | Value | Description |
|---|---|---|
| MP_STATUS_SUCCESS | 0 | Success. The message should be delivered. |
| MP_STATUS_RETRY | 1 | Retry the delivery of the message. |
| MP_STATUS_ABORT_DELIVERY | 2 | Abort message delivery. The message will be discarded. |
| MP_STATUS_BAD_MAIL | 3 | The message is malformed. Place it in the bad mail location. |
| MP_STATUS_SUBMITTED | 4 | The message is currently in the submitted state. |
| MP_STATUS_CATEGORIZED | 5 | The message has been successfully categorized. All group aliases have been expanded. |
Event sinks can alter the status of the message as it passes through the protocol and transport event pipeline. The SMTP service takes appropriate actions depending upon this status value. For example, if a sink updates a MailMsg object's IMMPID_MP_MESSAGE_STATUS property to MP_STATUS_ABORT_DELIVERY, the service will remove the message from the queue and discard it.