MSMQMessage.Trace (Windows Embedded CE 6.0)

1/6/2010

The property specifies how Message Queuing traces the route of the message.

Syntax

HRESULT get_Trace( 
  long* plTrace 
);
HRESULT put_Trace( 
  long lTrace
);

Parameters

• plTrace or lTrace
  Value that specifies how Message Queuing traces the route of the message. The following table shows the possible values.

  Value	Description
  MQMSG_SEND_ROUTE_TO_REPORT_QUEUE	Tracing is requested. Each hop made by the original message generates a report message that is sent to a report queue.
  MQMSG_TRACE_NONE	The default. Tracing is not requested.

Return Value

The following table describes the common return values.

Remarks

When tracing is enabled and a report queue is specified, report messages are created and sent to the report queue each time the message leaves or arrives at a Message Queuing computer.

For example, report messages are generated at the following times:

• When the message leaves the source computer, one report message is generated.
• When the message arrives at and leaves a routing server, two report messages are generated.
• When the message arrives the target computer where the destination queue resides, one report message is generated.

Report queues are specified by the computer. If MQMSG_SEND_ROUTE_TO_REPORT_QUEUE is specified but the report queue is not specified, this property is ignored.

Message Queuing does not support tracing under the following conditions.

• When you send messages to multiple destinations using distribution lists, multicast addresses, and multiple-element format names.
• When you send HTTP messages.

Equivalent Function property

When using functions, you can set the tracing level of the message using the PROPID_M_TRACE property.

Requirements

See Also

Reference

MSMQMessage
PROPID_M_TRACE