PROPID_M_JOURNAL

The PROPID_M_JOURNAL property specifies if the message should be kept in a machine journal (on the originating machine), sent to a dead letter queue, or neither.

Type Indicator

VT_UI1

PROPVARIANT Field

bVal

Property Values

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

MQMSG_DEADLETTER

If the message is not delivered to the receiving application (for example, a message timer expired or an incorrect destination queue was specified), the message is sent to a dead letter queue. For non-transaction messages, the message is sent to the dead letter queue on the computer where the message is located. For transaction messages, the message is sent to the dead letter queue on the source machine.

MQMSG_JOURNAL

If the message is transmitted (from the originating machine to the next hop), it is kept in a journal queue on the originating machine.

MQMSG_JOURNAL_NONE

The default. The message is not kept in the originating machine's journal queue.

Remarks

PROPID_M_JOURNAL does not create a queue. Machine journals and dead letter queues are system queues generated by MSMQ. For information on machine journals and dead letter queues, see Journal Queues and Dead Letter Queues. For an example of reading messages from a machine journal or dead letter queue, see Reading Messages In a Queue.

MSMQ always sends transactional messages to the transaction dead letter queue (DEADXACT) on the source machine if the message is not delivered. For information on transactions, see MSMQ Transactions.

To use a machine journal or deadletter queue, pass PROPID_M_JOURNAL to MQSendMessage.

To see if the sending application is using a machine journal or dead letter queue, pass PROPID_M_JOURNAL to MQReceiveMessage and check the returned value. When passing PROPID_M_JOURNAL 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.

See Also

MQReceiveMessage, MQSendMessage