Applies To: Windows 10, Windows 7, Windows 8, Windows 8.1, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2, Windows Server Technical Preview, Windows Vista
The Delivery property of the MSMQMessage object specifies how Message Queuing delivers the message.
Property Delivery As Long
The Delivery property can have one of the following values:
In every hop along its route, the message is stored locally on disk until it is forwarded to the next computer. This guarantees delivery even in the case of a computer crash. When the message is placed in the destination queue, it is written to disk in a memory-mapped file.
The default. The message stays in volatile memory along its entire route until it is received. The message is not recovered if the computer where the message resides is rebooted. An express message delivered to a queue on a virtual server in a cluster will be lost if the virtual server fails over before the message is received.
The Delivery property is used to specify express or recoverable messaging. Express messaging provides faster throughput. Recoverable messaging guarantees that the message will be delivered even if a computer crashes while the message is en route to the queue. For a comparison of express and recoverable messaging, see Express and Recoverable Messaging.
Message Queuing always sets the delivery mechanism of transactional messages to MQMSG_DELIVERY_RECOVERABLE. For information on transactions, see Transactions.
Equivalent API Function Property
With API function calls, the equivalent property is PROPID_M_DELIVERY.
Windows NT/2000/XP: Included in Windows NT 4.0 SP3 and later.
Windows 95/98/Me: Included in Windows 95 and later.
Header: Declared in Mqoai.h.
Library: Use Mqoa.lib.