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

Функция 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

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

GetTraceEnableFlags

GetTraceEnableLevel