Method MIMEMessage():setDeliveryNotification() Professional
Configures the sending of Delivery Service Notification e-mails
:setDeliveryNotification( aNotify [, cRef] ) --> self
|"failure"||Send a DSN when mail delivery fails|
|"delay"||Send DSNs when mail delivery is delayed|
|"success"||Send DSN when mail delivery succeeds|
|"never"||Do not send any DSN|
|"full"||The notifications contain the complete original e-mail|
|"headers"||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.