Функция TdhGetEventInformation (tdh.h)

Статья
08/26/2023

Извлекает метаданные о событии.

Синтаксис

TDHSTATUS TdhGetEventInformation(
  [in]      PEVENT_RECORD     Event,
  [in]      ULONG             TdhContextCount,
  [in]      PTDH_CONTEXT      TdhContext,
  [out]     PTRACE_EVENT_INFO Buffer,
  [in, out] PULONG            BufferSize
);

Параметры

[in] Event

Запись события, переданная обратному вызову EventRecordCallback . Дополнительные сведения см. в разделе структура EVENT_RECORD .

[in] TdhContextCount

Количество элементов в pTdhContext.

[in] TdhContext

Массив значений контекста только для событий WPP или классической трассировки событий Windows; в противном случае — NULL. Дополнительные сведения см. в разделе структура TDH_CONTEXT . Массив не должен содержать повторяющиеся типы контекста.

[out] Buffer

Выделенный пользователем буфер для получения сведений о событии. Дополнительные сведения см. в разделе структура TRACE_EVENT_INFO .

[in, out] BufferSize

Размер буфера pBuffer в байтах. Если функция выполняется успешно, этот параметр получает размер используемого буфера. Если буфер слишком мал, функция возвращает ERROR_INSUFFICIENT_BUFFER и задает для этого параметра требуемый размер буфера. Если размер буфера равен нулю на входных данных, данные в буфере не возвращаются, и этот параметр получает требуемый размер буфера.

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

В случае успешного выполнения возвращает ERROR_SUCCESS. В противном случае эта функция возвращает один из следующих кодов возврата в дополнение к другим.

Код возврата	Описание
ERROR_INSUFFICIENT_BUFFER	Размер буфера pBuffer слишком мал. Используйте требуемый размер буфера, заданный в pBufferSize , чтобы выделить новый буфер.
ERROR_NOT_FOUND	Схема для события не найдена.
ERROR_INVALID_PARAMETER	Один или несколько параметров являются недопустимыми.
ERROR_FILE_NOT_FOUND	Атрибут resourceFileName в манифесте содержит расположение двоичного файла поставщика. При регистрации манифеста расположение записывается в реестр. TDH не удалось найти двоичный файл на основе зарегистрированного расположения.
ERROR_WMI_SERVER_UNAVAILABLE	Служба WMI недоступна.

Если событие является событием WPP или устаревшим событием трассировки событий Windows, можно указать контекстные сведения, которые используются для анализа сведений о событии. Событие является событием WPP, если флаг EVENT_HEADER_FLAG_TRACE_MESSAGE установлен в элементе FlagsEVENT_HEADER (см. элемент EventHeaderEVENT_RECORD). Событие является устаревшим событием трассировки событий Windows, если установлен флаг EVENT_HEADER_FLAG_CLASSIC_HEADER.

Примеры

Пример получения метаданных о событии см. в разделе Использование TdhFormatProperty для использования данных события.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	tdh.h
Библиотека	Tdh.lib
DLL	Tdh.dll

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

TdhGetEventMapInformation

TdhGetProperty

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