Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This 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.

Value Description

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 source Queue Manager of the message, this property is ignored.

To set where report messages are sent, specify PROPID_M_TRACE in the MQMSGPROPSstructure and call MQSendMessage.

To retrieve where report messages are sent, specify PROPID_M_TRACE in the MQMSGPROPSstructure. Then call MQReceiveMessageand examine the returned value.

When specifying PROPID_M_TRACE, you can set its Type Indicator to VT_NULL. When the Type Indicator is set to VT_NULL, MSMQ sets the VT field to the appropriate type indicator.

Examples

This example shows how PROPID_M_TRACEis specified in the MQMSGPROPSstructure.

Copy Code 
aMsgPropId[i] = PROPID_M_TRACE;
aMsgPropVar[i].vt = VT_UI1;
aMsgPropVar[i].bVal = MQMSG_SEND_ROUTE_TO_REPORT_QUEUE;
 i++;
Note:
OS versions prior to 2.12 require the MSMQ add-on pack.

Requirements

Header mq.h
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also