Функция GetTraceEnableLevel (evntrace.h)

Статья
08/23/2023

Поставщик событий на основе RegisterTraceGuids ("Классическая") использует функцию GetTraceEnableLevel для получения уровня включения, заданного контроллером трассировки, чтобы указать, какой уровень событий следует отслеживать.

Поставщики вызывают эту функцию из своей функции ControlCallback .

Синтаксис

UCHAR WMIAPI GetTraceEnableLevel(
  [in] TRACEHANDLE TraceHandle
);

Параметры

[in] TraceHandle

Обработка сеанса трассировки событий, полученного путем вызова функции GetTraceLoggerHandle .

Возвращаемое значение

Возвращает значение контроллера, указанного в параметре EnableLevel при вызове функции EnableTrace .

Чтобы определить, произошел ли сбой функции или контроллер установил для флагов включения значение 0, выполните следующие действия.

Вызовите функцию SetLastError , чтобы задать для последней ошибки значение ERROR_SUCCESS.
Вызовите функцию GetTraceEnableLevel , чтобы получить уровень включения.
Если значение уровня включения равно 0, вызовите функцию GetLastError , чтобы получить последнюю известную ошибку.
Если последняя известная ошибка ERROR_SUCCESS, контроллер устанавливает уровень включения равным 0; В противном случае функция GetTraceEnableLevel завершилась сбоем с последней известной ошибкой.

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

Примеры

Пример использования GetTraceEnableLevel см. в разделе Извлечение данных событий с помощью MOF.

Требования


Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	evntrace.h
Библиотека	Advapi32.lib
DLL	Advapi32.dll

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

GetTraceEnableFlags

GetTraceLoggerHandle

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