PROPID_M_TRACE

The PROPID_M_TRACE property specifies where report messages are sent when tracing a message.

Type Indicator

VT_UI1 (or VT_NULL)

PROPVARIANT Field

bVal

Property Values

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

MQMSG_SEND_ROUTE_TO_REPORT_QUEUE

Each hop made by the original message generates a report that is recorded in a report message. The elements of the report are the source Queue Manager, message identifier, target, time, and next hop. The report message is sent to the report queue specified by the source Queue Manager.

MQMSG_TRACE_NONE

The default. No tracing for this message.

Remarks

If MQMSG_SEND_ROUTE_TO_REPORT_QUEUE is specified but the report queue is not defined by the MSMQ administrator for the message's source Queue Manager, this property is ignored.

When passing PROPID_M_TRACE to MQReceiveMessage, the corresponding VT field in the aPropVar array can be set to VT_NULL.

For a description of report queues and messages, see Report Queues and Report Messages.

For information on machine journals, see Journal Queues.

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.