Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This property specifies how Message Queuing delivers the message.
HRESULT get_Delivery( long* plDelivery);HRESULT put_Delivery( longlDelivery);
Parameters
- plDelivery or lDelivery
Value that specifies how Message Queuing delivers the message. The following table shows the possible values.Value Description 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 the case of a computer crash.
MQMSG_DELIVERY_EXPRESS The default. The message stays in memory until it can be delivered.
Return Values
The following table describes the common return values.
| Value | Description |
|---|---|
| S_OK | Success |
| E_INVALIDARG | One or more arguments are invalid |
| E_NOTIMPL | The function contains no implementation |
| E_OUTOFMEMORY | Out of memory |
Remarks
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.
Message Queuing always sets the delivery mechanism of transactional messages to MQMSG_DELIVERY_RECOVERABLE.
Equivalent Function Property
When using function calls, the delivery type can be set and retrieved using the PROPID_M_DELIVERY message property.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Mqoai.h.
Link Library: Mqoa.lib.
See Also
MSMQMessage | PROPID_M_DELIVERY
Send Feedback on this topic to the authors