ITracer interface (wdtf.h)
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.
Inheritance
The ITracer interface inherits from the IDispatch interface. ITracer also has these types of members:
- Methods
Methods
The ITracer interface has these methods.
| ITracer::GetBits 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. |
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 flag | Meaning | Bit | Default 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\
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | wdtf.h |