RequestDeliveryReport
MSMQMailEMail

The RequestDeliveryReport property specifies whether the receiving application should return a delivery report when the e-mail is received.

Type:	Boolean
Run time:	Read-write

Syntax

object.RequestDeliveryReport

Syntax Element	Description
object	E-mail (MSMQMailEMail) object that represents the e-mail message.

Settings

Boolean (default is False).

Remarks

If RequestDeliveryReport is set to True, the receiving application should send a delivery report e-mail for the delivered recipients.

The default setting of this property is False.

Example

This example defines a text-message e-mail, setting its RequestDeliveryReport to True. The e-mail object is then used to compose the body of a mail message, and a message box displays the e-mail's subject.

To try this example using Microsoft Visual Basic (version 5.0), paste the code into the Code window of a form, run the example, and click the form.

Dim email As New MSMQMailEMail
Dim msg As New MSMQMessage

Private Sub Form_Click()

   '***********************
   '*  Define e-mail object
   '***********************
   
   'Set e-mail type to text message
   email.ContentType = MSMQMAIL_EMAIL_TEXTMESSAGE
   
   'Add Recipients
   email.Recipients.Add "Connector Recipient Name", "ExchangeUser@ServerInputQueueLabel", MSMQMAIL_RECIPIENT_TO
   email.Recipients.Add "MAPI Recipient Name", "MAPIUserInputQueueLabel", MSMQMAIL_RECIPIENT_CC

   'Set who sent the e-mail.
   email.Sender.Name = "Our name"
   email.Sender.Address = "Our queue label"

   'Set the subject of the e-mail.
   email.Subject = "Test mail."

   'Request delivery report.
   email.RequestDeliveryReport = True

   'Set the Body of the e-mail.
   email.TextMessageData.Text = "This is the Body of the message."
   
   '**********************
   '* Compose message Body
   '**********************
   msg.Body = email.ComposeBody

   '******************
   '* Display delivery report flag.
   '******************
   MsgBox "Request a delivery report for the e-mail:" + email.RequestDeliveryReport

End Sub

QuickInfo

  Windows NT: Requires version 4.0 SP3 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Import Library: Included as a resource in mqmailoa.dll.
  Unicode: Defined only as Unicode.