PROPID_M_DELIVERY

The PROPID_M_DELIVERY property specifies how the message is delivered.

Type Indicator

VT_UI1 (or VT_NULL)

PROPVARIANT Field

bVal

Property Values

This property can be set to one of the following values:

MQMSG_DELIVERY_RECOVERABLE

In every hop along its route, the message is forwarded to the next hop or stored locally in a backup file until delivered. This guarantees delivery even in case of a computer crash.

MQMSG_DELIVERY_EXPRESS

The default. The message stays in memory until it can be delivered. The message is not recovered if the computer is rebooted.

Remarks

When the message's delivery mechanism is set to MQMSG_DELIVERY_EXPRESS, the message has faster throughput. When set to MQMSG_DELIVERY_RECOVERABLE, throughput may be slower, but MSMQ guarantees that the message will be delivered, even if a computer crashes while the message is en-route to the queue.

MSMQ always sets the delivery property of transactional messages to MQMSG_DELIVERY_RECOVERABLE. For information on transactions, see MSMQ Transactions.

To see how a message will be delivered, pass PROPID_M_DELIVERY to MQSendMessage.

To determine how a message was delivered, pass PROPID_M_DELIVERY to MQReceiveMessage and examine its returned value. When passing PROPID_M_DELIVERY to MQReceiveMessage, the corresponding VT field in the aPropVar array can be set to VT_NULL.

QuickInfo

  Windows NT: Requires version 4.0 SP3 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in mq.h.
  Import Library: Use mqrt.lib.
  Unicode: Defined only as Unicode.