TraceLoggingThreadActivity-Klasse (traceloggingactivity.h)

Bietet Unterstützung für die Protokollierung von ETW-Ereignissen während einer Aktivität. Ereignisse werden automatisch mit dieser Aktivität markiert oder geschachtelt.

Vererbung

Die TraceLoggingThreadActivity-Klasse implementiert _TlgActivityBase.

Methoden

Die TraceLoggingThreadActivity-Klasse verfügt über diese Methoden.

TraceLoggingThreadActivity::P rovider TraceLoggingThreadActivity::P rovider (traceloggingactivity.h) gibt das Handle an den TraceLogging-Anbieter zurück, der dieser Aktivität zugeordnet ist.
TraceLoggingThreadActivity::TraceLoggingThreadActivity Initialisiert eine neue instance der TraceLoggingThreadActivity-Klasse. (Überladung 2/2)
TraceLoggingThreadActivity::TraceLoggingThreadActivity Initialisiert eine neue instance der TraceLoggingThreadActivity-Klasse. (Überladung 1/2)

Hinweise

Diese Klasse funktioniert, indem eine Variable pro Thread festgelegt wird. Nur Ereignisse, die im aktiven Thread auftreten, werden automatisch markiert.

Um TraceLogging-Aktivitäten verwenden zu können, müssen Sie eine instance von TraceLoggingActivity oder TraceLoggingThreadActivity definieren. Nachdem Sie eine instance einer dieser Klassen erstellt haben, bearbeiten Sie die Aktivitätsprotokollierung mit Nachdem Sie eine instance einer dieser Klassen erstellt haben, bearbeiten Sie die Aktivitätsprotokollierung mithilfe von TraceLoggingFunction, TraceLoggingWriteStart, TraceLoggingWriteStop und TraceLoggingWriteTagged. Diese Klasse erstellt automatisch einen eindeutigen Bezeichner, wenn die Ablaufverfolgung aktiviert und die Aktivität gestartet wird.

Alle aktiven Threads werden automatisch in dieser instance geschachtelt, wenn Sie mit der Protokollierung mit einem TraceLoggingThreadActivity-Objekt beginnen. Darüber hinaus werden alle Ereignisse automatisch mit dem eindeutigen Bezeichner dieses Objekts protokolliert.

Wichtig

Verwenden Sie diese Klasse nur, wenn Sie garantieren können, dass alle Aktivitäten für diesen Thread vollständig geschachtelt sind. Sie müssen sicherstellen, dass keine untergeordnete Aktivität eine übergeordnete Aktivität überdauert, auch nicht in Fehler- oder Edgefällen.

Hinweis

In DEBUG-Builds löst die -Klasse eine Assertion während des Stop-Ereignisses aus, wenn sie eine falsche Aktivitätsschachtelung erkennt oder wenn das Stop-Ereignis in einem anderen Thread als dem Thread auftritt, der zum Starten verwendet wird.

Diese Klasse ist für Speicheranwendungen nicht verfügbar.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	traceloggingactivity.h

Weitere Informationen

TraceLoggingActivity-Klasse