ITracer interface

The ITracer interface enables individual instances of every WDTF interface to determine the specific tracing settings for a given implementation coclass. These settings are recorded in the registry.

Members

The ITracer interface inherits from the IDispatch interface. ITracer also has these types of members:

Methods

The ITracer interface has these methods.

MethodDescription
GetBits

Retrieves the tracing bit mask for this coclass, given a specified trace-level.

 

Remarks

You will typically never see the ITracer interface. In fact, even if you are building WDTF action plug-ins, you will probably not need to use this interface. ITracer is implemented in WDTF.dll and provides the global definitions for the specific settings that are associated with each TTraceLevel enumeration value.

The following table describes the internal flags for WDTF tracing. The individual levels within the TTraceLevel enumeration correspond to a set of internal tracing flags. The registry key that is listed in TraceLevel Path (in the following Implementation Details section) contains the bit masks for each TTraceLevel, as the following table shows.

Trace2_Medium contains all of the Trace1_Low flags, and Trace3_High contains all of the Trace2_Medium flags.

Trace flagMeaningBitDefault trace level

COMEntryExit

A COM method or property for entry and exit

0x0001

Trace1_Low

COMError

An error was found by a COM method or property

0x0002

Trace1_Low

EntryExit

A C++ function for entry and exit

0x0004

Trace2_Medium

APICall

About to call into an API

0x0008

Trace2_Medium

Info

Extra information

0x0010

Trace2_Medium

Warning

Warning that something might be wrong

0x0020

Trace1_Low

Error

An error was found within WDTF

0x0040

Trace1_Low

NoisyCOMEntryExit

The noisy version of the COMError flag

0x0080

Trace3_High

NoisyEntryExit

The noisy version of the EntryExit flag

0x0100

Trace3_High

NoisyAPICall

The noisy version of the APICall flag

0x0200

Trace3_High

NoisyInfo

The noisy version of the Info flag

0x0400

Trace3_High

NoisyWarning

The noisy version of the Warning flag

0x0800

Trace3_High

 

Implementation Details

ProgID: WDTF.Tracer

TraceLevel Path: HKCR\WDTF.Tracer.1\

Note  The implementation of the ITracer interface is thread-safe.

Requirements

Type library

WDTF.tlb

See also

TTraceLevel
ITracing

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft