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