Freigeben über


ITracer::GetBits-Methode (wdtf.h)

Die GetBits--Methode gibt den Satz von Ablaufverfolgungskennzeichnungen für eine Coclass als Bitmaske zurück, wobei ein angegebenes TTraceLevel--Wert und die CLSID der Coclass angegeben ist.

Syntax

HRESULT GetBits(
  [in]          CLSID       ClassID,
  [in]          TTraceLevel Level,
  [out, retval] DWORD       *pBits
);

Parameter

[in] ClassID

Die CLSID der Co-Klasse des Objekts, das die Bitmaske für die Ablaufverfolgung anfordert. Dieser Parameter bewirkt, dass die TraceLevel Path- der Schnittstelle als HKCR\CLSID<ClassID->definiert wird.

[in] Level

Die angeforderte Ablaufverfolgungsebene. Ein Wert von Trace_Default gibt an, dass GetBits- den TraceLevel-Pfad der Schnittstelle nach der Standardebene durchsucht. TraceLevel Path wird mithilfe ClassID- oder pszTraceLevelPath-angegeben. .

[out, retval] pBits

Der zurückgegebene Satz von Flags als Bitmaske.

Rückgabewert

GetBits- gibt einen Standardwert HRESULT- zurück.

Bemerkungen

Die GetBits--Methode ist für die WdTF-Verwendung auf niedriger Ebene vorgesehen. Wenn Sie die Ablaufverfolgungsebene eines Objekts zur Laufzeit ändern möchten, lesen Sie ITracing.

Wenn keine Standardablaufverfolgungsebene vorhanden ist, schlägt diese Methode fehl.

Wenn GetBits- aus irgendeinem Grund fehlschlägt, wird erwartet, dass der Aufrufer die Ablaufverfolgungsbitmaske des Erstellers weiterhin im Hintergrund verwendet.

Anforderungen

Anforderung Wert
Zielplattform- Desktop
Header- wdtf.h

Siehe auch

ITracer-

ITracing-

TTraceLevel-