ITracer::GetBits method (wdtf.h)

The GetBits method returns the set of tracing flags for a coclass as a bit mask, given a specified TTraceLevel value and the CLSID of the coclass.

Syntax

HRESULT GetBits(
  [in]          CLSID       ClassID,
  [in]          TTraceLevel Level,
  [out, retval] DWORD       *pBits
);

Parameters

[in] ClassID

The CLSID of the co-class of the object that is requesting the tracing bit mask. This parameter causes the interface's TraceLevel Path to be defined as HKCR\CLSID<ClassID>.

[in] Level

The tracing level that is requested. A value of Trace_Default indicates that GetBits will search the interface's TraceLevel Path for the default level. TraceLevel Path is specified by using either ClassID or pszTraceLevelPath. .

[out, retval] pBits

The returned set of flags as a bit mask.

Return value

GetBits returns a standard HRESULT value.

Remarks

The GetBits method is intended for low-level WDTF usage. If you want to change the trace level of an object at runtime, see ITracing.

If no default trace level exists, this method fails.

If GetBits fails for any reason, the caller is expected to silently continue to use the tracing bit mask of its creator.

Requirements

Requirement Value
Target Platform Desktop
Header wdtf.h

See also

ITracer

ITracing

TTraceLevel