Функция GetTraceEnableFlags (evntrace.h)
Поставщик событий на основе RegisterTraceGuids ("Классическая") использует функцию GetTraceEnableFlags для получения флагов включения, заданных контроллером трассировки, чтобы указать категорию событий для трассировки.
Поставщики вызывают эту функцию из своей функции ControlCallback .
Синтаксис
ULONG WMIAPI GetTraceEnableFlags(
[in] TRACELOGGER_HANDLE TraceHandle
);
Параметры
[in] TraceHandle
Обработка сеанса трассировки событий, полученного путем вызова функции GetTraceLoggerHandle .
Возвращаемое значение
Возвращает значение контроллера, указанного в параметре EnableFlag при вызове функции EnableTrace .
Чтобы определить, произошел ли сбой функции или контроллер установил для флагов включения значение 0, выполните следующие действия.
- Вызовите функцию SetLastError , чтобы задать для последней ошибки значение ERROR_SUCCESS.
- Вызовите функцию GetTraceEnableFlags , чтобы получить флаги включения.
- Если значение флагов включения равно 0, вызовите функцию GetLastError , чтобы получить последнюю известную ошибку.
- Если последняя известная ошибка ERROR_SUCCESS, контроллер устанавливает для флагов включения значение 0; в противном случае функция GetTraceEnableFlags завершилась сбоем с последней известной ошибкой.
Комментарии
Поставщики могут использовать это значение для управления создаваемыми событиями. Например, поставщик может группировать события в логические категории событий и использовать это значение для включения или отключения их создания.
Примеры
Пример использования GetTraceEnableFlags см. в разделе Извлечение данных событий с помощью MOF.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Профессиональная [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows 2000 Server [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | evntrace.h |
| Библиотека | Advapi32.lib |
| DLL | Advapi32.dll |