Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The property specifies how Message Queuing traces the route of the message.
HRESULT get_Trace( long* plTrace);HRESULT put_Trace( longlTrace);
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 Values
The following table describes the common return values.
| Value | Description |
|---|---|
| S_OK | Success |
| E_INVALIDARG | One or more arguments are invalid |
| E_NOTIMPL | The function contains no implementation |
| E_OUTOFMEMORY | Out of memory |
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
OS Versions: Windows CE .NET 4.0 and later.
Header: Mqoai.h.
Link Library: Mqoa.lib.
See Also
Send Feedback on this topic to the authors