Share via

CWTTLogger::TraceMsgV method

  • Article

The TraceMsgV method logs a trace of the specified device at the user-defined trace level and a given priority by using a prepared argument list.

Syntax

HRESULT TraceMsgV(
  LONG hDevice,
  LPWSTR pwszUserDefinedLevel,
  DWORD dwPriority,
  va_list VarArgs
);

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] The priority of the trace. This parameter should be one of the following values: WTT_TRACE_PRIORITY_HIGH_CLASSWTT_TRACE_PRIORITY_MEDIUM_CLASSWTT_TRACE_PRIORITY_LOW_CLASSWTT_TRACE_PRIORITY_RESERVED_CLASSWTT_TRACE_PRIORITY_USER_CLASS

  • VarArgs
    [in] A prepared list of variable arguments as required for the specified trace level. For information about the arguments that are required for each trace level, see Trace Level.

Return value

TraceMsgV returns one of the following values:

Return code Description
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

Header

 Wttlogger.h

Library

 WTTLog.dll

See also

CWTTLogger Class (C++)

CWTTLogger::Trace

CWTTLogger::TraceMsg

 

 

Build date: 9/14/2012