Функция GetTraceLoggerHandle (evntrace.h)
Поставщик событий на основе RegisterTraceGuids ("Классическая") использует функцию GetTraceLoggerHandle для получения дескриптора сеанса трассировки событий, в который он должен записывать события.
Поставщики вызывают эту функцию из своей функции ControlCallback .
Синтаксис
TRACEHANDLE WMIAPI GetTraceLoggerHandle(
[in] PVOID Buffer
);
Параметры
[in] Buffer
Указатель на структуру WNODE_HEADER . EtW передает эту структуру в функцию ControlCallback поставщика в параметре Buffer .
Элемент HistoricalContextWNODE_HEADER содержит дескриптор сеанса.
Возвращаемое значение
Если функция выполняется успешно, она возвращает дескриптор сеанса трассировки событий.
Если функция завершается сбоем, она возвращает INVALID_HANDLE_VALUE. Чтобы получить расширенные сведения об ошибке, вызовите функцию GetLastError .
Комментарии
Дескриптор используется при вызове функций GetTraceEnableFlags и GetTraceEnableLevel для получения флагов и значений уровня, передаваемых в функцию EnableTrace .
Примеры
Пример использования GetTraceLoggerHandle см. в разделе Извлечение данных событий с помощью MOF.
Требования
| Минимальная версия клиента | Windows 2000 Профессиональная [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows 2000 Server [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | evntrace.h |
| Библиотека | Advapi32.lib |
| DLL | Advapi32.dll |