ITracer 接口 (wdtf.h)
ITracer 接口允许每个 WDTF 接口的各个实例确定给定实现 coclass 的特定跟踪设置。 这些设置记录在注册表中。
遗产
ITracer 接口继承自 IDispatch 接口。 ITracer 也有以下类型的成员:
- 方法
方法
ITracer 接口具有这些方法。
ITracer::GetBits GetBits 方法将 coclass 的跟踪标志集作为位掩码返回,给定指定的 TTraceLevel 值和 coclass 的 CLSID。 |
言论
通常永远不会看到 ITracer 接口。 事实上,即使要生成 WDTF作插件,也可能不需要使用此接口。 ITracer 在 WDTF.dll 中实现,并为与每个 TTraceLevel 枚举值关联的特定设置提供全局定义。
下表描述了 WDTF 跟踪的内部标志。 TTraceLevel 中的单个级别 枚举对应于一组内部跟踪标志。 TraceLevel Path(以下实现详细信息部分)中列出的注册表项包含每个 TTraceLevel 的位掩码,如下表所示。
Trace2_Medium包含所有Trace1_Low标志,Trace3_High包含所有Trace2_Medium标志。
跟踪标志 | 意义 | 位 | 默认跟踪级别 |
---|---|---|---|
COMEntryExit | 用于进入和退出的 COM 方法或属性 | 0x0001 | Trace1_Low |
COMError | COM 方法或属性发现了错误 | 0x0002 | Trace1_Low |
EntryExit | 用于进入和退出的C++函数 | 0x0004 | Trace2_Medium |
APICall | 即将调用 API | 0x0008 | Trace2_Medium |
信息 | 额外信息 | 0x0010 | Trace2_Medium |
警告 | 警告出现错误 | 0x0020 | Trace1_Low |
错误 | WDTF 中发现了错误 | 0x0040 | Trace1_Low |
NoisyCOMEntryExit | COMError 标志的干扰版本 | 0x0080 | Trace3_High |
NoisyEntryExit | EntryExit 标志的干扰版本 | 0x0100 | Trace3_High |
NoisyAPICall | APICall 标志的干扰版本 | 0x0200 | Trace3_High |
NoisyInfo | 信息标志的干扰版本 | 0x0400 | Trace3_High |
NoisyWarning | 警告标志的干扰版本 | 0x0800 | Trace3_High |
实现详细信息
ProgID:WDTF。示 踪
TraceLevel 路径:HKCR\WDTF。Tracer.1\
注意ITracer 接口的实现是线程安全的。
要求
要求 | 价值 |
---|---|
目标平台 | 窗户 |
标头 | wdtf.h |