Поделиться через


Класс TraceLoggingThreadActivity (traceloggingactivity.h)

Обеспечивает поддержку ведения журнала событий трассировки событий Windows во время действия. События будут автоматически помечены или вложены в это действие.

Наследование

Класс TraceLoggingThreadActivity реализует _TlgActivityBase.

Методы

Класс TraceLoggingThreadActivity содержит следующие методы.

 
TraceLoggingThreadActivity::P rovider

TraceLoggingThreadActivity::P rovider (traceloggingactivity.h) возвращает дескриптор поставщику TraceLogging, связанному с этим действием.
TraceLoggingThreadActivity::TraceLoggingThreadActivity

Инициализирует новый экземпляр класса TraceLoggingThreadActivity. (перегрузка 2/2)
TraceLoggingThreadActivity::TraceLoggingThreadActivity

Инициализирует новый экземпляр класса TraceLoggingThreadActivity. (перегрузка 1/2)

Комментарии

Этот класс работает путем задания переменной для каждого потока. Автоматически помечаются только события, происходящие в активном потоке.

Чтобы использовать действия TraceLogging, необходимо определить экземпляр TraceLoggingActivity или TraceLoggingThreadActivity. После создания экземпляра одного из этих классов вы управляете ведением журнала действий с помощью После создания экземпляра одного из этих классов вы управляете ведением журнала действий с помощью TraceLoggingFunction, TraceLoggingWriteStart, TraceLoggingWriteStop и TraceLoggingWriteTagged. Этот класс автоматически создает уникальный идентификатор при включении трассировки и запуске действия.

Все активные потоки будут автоматически вложены в этот экземпляр при запуске ведения журнала с помощью объекта TraceLoggingThreadActivity . Кроме того, все события будут автоматически записываться в журнал с помощью уникального идентификатора этого объекта.

Важно!

Используйте этот класс только в том случае, если можно гарантировать, что все действия для этого потока полностью вложены. Необходимо убедиться, что никакие дочерние действия не будут перехигрывать родительское действие даже в случаях ошибок или пограничных случаях.

Примечание

В сборках DEBUG класс вызывает утверждение во время события Stop, если обнаруживает неправильную вложенную активность или событие Stop возникает в потоке, отличном от потока, используемого для его запуска.

Этот класс недоступен для приложений магазина.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2012 R2 [только классические приложения]
Целевая платформа Windows
Header traceloggingactivity.h

См. также раздел

Класс TraceLoggingActivity