PROPID_M_TRACE

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 values listed in the following table.
    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 MQMSGPROPS structure and call MQSendMessage.

To retrieve where report messages are sent, specify PROPID_M_TRACE in the MQMSGPROPS structure. Then call MQReceiveMessage and 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.

Example

This example shows how PROPID_M_TRACE is specified in the MQMSGPROPS structure.

aMsgPropId[i] = PROPID_M_TRACE;
aMsgPropVar[i].vt = VT_UI1;
aMsgPropVar[i].bVal = MQMSG_SEND_ROUTE_TO_REPORT_QUEUE;
 i++; 

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 2.0 and later. Versions prior to 2.12 require the MSMQ add-on pack. Mq.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

MQReceiveMessage, MQSendMessage, MQMSGPROPS

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.