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 |