CWTTLogger::TraceMsg

The TraceMsg method logs a trace of the specified device at the user-defined trace level and a given priority.

HRESULT TraceMsg (
  LONG  hDevice,
  LPWSTR  pwszUserDefinedLevel,
  DWORD  dwPriority,
  ...
);

Parameters

hDevice

[in] A handle to the device tracing topology. You can combine multiple handles by using the bitwise OR operator (for example, hDevice1 OR hDevice2).

pwszUserDefinedLevel

[in] A user-defined trace level.

dwPriority

...

[in] One or more optional arguments that depend on the user-defined trace level.

Return Value

TraceMsg returns one of the following values:

  • S_OK
    The operation was successful.
  • S_FALSE
    The operation was successful but the last device has been detached, which has triggered a rollup.
  • HRESULT
    The operation failed. You should use the FAILED macro to check HRESULT values.

Requirements

Headers: Wttlogger.h

Library: WTTLog.dll

See Also

CWTTLogger Class (C++), CWTTLogger::Trace, CWTTLogger::TraceMsg

Send feedback on this topic
Built on December 10, 2009