ITracer::GetBits 方法 (wdtf.h)
GetBits 方法會以位掩碼的形式傳回 coclass 的追蹤旗標集,因為指定的 TTraceLevel 值和 coclass 的 CLSID。
語法
HRESULT GetBits(
[in] CLSID ClassID,
[in] TTraceLevel Level,
[out, retval] DWORD *pBits
);
參數
[in] ClassID
要求追蹤位掩碼之物件共同類別的CLSID。 此參數會使介面的 TraceLevel Path 定義為 HKCR\CLSID<ClassID>。
[in] Level
要求的追蹤層級。 Trace_Default 值表示 GetBits 會搜尋介面的 TraceLevel Path 作為預設層級。 TraceLevel Path 是使用 ClassID 或 pszTraceLevelPath 來指定。 .
[out, retval] pBits
傳回的旗標集做為位掩碼。
傳回值
GetBits 會傳回標準 HRESULT 值。
言論
GetBits 方法適用於低階 WDTF 使用方式。 如果您要在執行時間變更物件的追蹤層級,請參閱 ITracing。
如果沒有任何默認追蹤層級存在,這個方法就會失敗。
如果 GetBits 因任何原因而失敗,則呼叫端應該會以無訊息方式繼續使用其建立者的追蹤位掩碼。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | wdtf.h |