ITracer 介面 (wdtf.h)
ITracer 介面可讓每個 WDTF 介面的個別實例判斷指定實作 coclass 的特定追蹤設定。 這些設定會記錄在登錄中。
遺產
ITracer 介面繼承自 IDispatch 介面。 ITracer 也有下列類型的成員:
- 方法
方法
ITracer 介面具有這些方法。
ITracer::GetBits GetBits 方法會根據指定的 TTraceLevel 值和 coclass 的 CLSID,以位掩碼的形式傳回 coclass 的追蹤旗標集合。 |
言論
您通常永遠不會看到 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 | Info 旗標的嘈雜版本 | 0x0400 | Trace3_High |
NoisyWarning | 警告旗標的嘈雜版本 | 0x0800 | Trace3_High |
實作詳細數據
ProgID:WDTF。示蹤
TraceLevel 路徑:HKCR\WDTF。Tracer.1\
注意 ITracer 介面 實作是安全線程的。
要求
要求 | 價值 |
---|---|
目標平臺 | 窗戶 |
標頭 | wdtf.h |