Method MIMEMessage():setDeliveryNotification() Professional
Configures the sending of Delivery Service Notification e-mails
:setDeliveryNotification( aNotify [, cRef] ) --> self
|Send a DSN when mail delivery fails
|Send DSNs when mail delivery is delayed
|Send DSN when mail delivery succeeds
|Do not send any DSN
|The notifications contain the complete original e-mail
|Only the headers of the original e-mail are included
On the way to the recipient of an e-mail, the Mail Transfer Agents or Mail Delivery Agents involved can send back so-called delivery status notifications (DSNs) to the sender. These notifications are delivered as separate e-mails to the sender's inbox. DSNs can be generated if the transmission is successful, delayed or failed. The parameter <aNotify> can be used to specify for which of these events a DSN shall be sent. Alternatively, the sending of delivery status notifications can be switched off.
A DSN contains an attachment to refer to the original e-mail. The parameter <cRef> can be used to determine whether this attachment contains the complete original e-mail or only its headers.
The method :setDeliveryNotification() generates a runtime error if incorrect parameters are passed.
This shows various examples for requesting Delivery Status Notifications:
If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.