MDNRequested Property

MDNRequested Property

Exchange Server 2003

MDNRequested Property

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Indicates whether a Mail Delivery Notification (MDN) report is requested for a message.

Applies To

Type Library

Microsoft CDO for Exchange 2000 Library

DLL Implemented In



        [Visual Basic]Property MDNRequested As Boolean
        [C++]HRESULT get_MDNRequested(VARIANT_BOOLpVal);


Returns the value of the MDNRequested property as a reference to a VARIANT_BOOL.
Sets the value of the MDNRequested property to the value of the VARIANT_BOOL.


An MDN is a request for disposition information from a recipient after the message has been successfully delivered. This disposition might include whether the message was displayed, printed, or deleted without display, or if a recipient refused to send MDNs. The message sender or an intermediary Message Transfer Agent can request MDNs. The returned MDN report message is nested in a message with Content-Type of multipart/report. RFC 2298 describes MDNs, their function and format.

To request an MDN for a message, set the urn:schemas:mailheader:disposition-notification-to header field to the sender's e-mail address. Optionally, set the urn:schemas:mailheader:disposition-notification-options header field to the appropriate value. Then send the message. To remove a previously added MDN header field, delete it using the IMessage.Fields.Delete method.


' WSH Source file.
' Assume
'   <reference object="adodb.record"/>
'   <reference object="cdo.message"/>
' exist to resolve type names using the
' type libraries.

sub mdnexample()

 set msg = createobject("cdo.message")

 with msg
   set conf = .configuration
   with conf
     .fields(cdoSendEmailAddress)          = ""
     .fields(cdoSendUserReplyEmailAddress) = ""
   end with

   .to            = ""
   .from          = ""
   .subject       = "Need to know you got this."
   .textbody      = "here is the important message."
   .mdnrequested  = true
   .fields(cdoDispositionNotificationTo) = ""

   wscript.echo .getstream.readtext
   ' .send

  ' next, send the message to others without MDNs

  .To = ""

  wscript.echo .getstream.readtext
  ' .send
 end with

end sub

        [Visual Basic]

See the VBScript example.


See the VBScript example.

See Also

DSNOptions Property

© 2016 Microsoft