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

Функция SetTraceCallback указывает функцию EventCallback для обработки событий для указанного класса трассировки событий.

Синтаксис

ULONG WMIAPI SetTraceCallback(
  [in] LPCGUID         pGuid,
  [in] PEVENT_CALLBACK EventCallback
);

Параметры

[in] pGuid

Указатель на GUID класса класса класса трассировки событий, для которого требуется получать события. Список идентификаторов GUID класса поставщика ядра см. в разделе "Константы средства ведения журнала ядра NT".

[in] EventCallback

Указатель на функцию EventCallback , используемую для обработки событий, принадлежащих классу трассировки событий.

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

Если функция выполнена успешно, возвращаемое значение ERROR_SUCCESS.

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

• ERROR_INVALID_PARAMETER

  Верно одно из условий ниже:

  • pGuid имеет значение NULL.
  • EventCallback имеет значение NULL.

Замечания

Потребители вызывают эту функцию.

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

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

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

Требования

См. также

EventCallback

ProcessTrace

RemoveTraceCallback