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

Статья
08/26/2023

Функция TdhGetManifestEventInformation извлекает метаданные о событии в манифесте.

Синтаксис

TDHSTATUS TdhGetManifestEventInformation(
  [in]      LPGUID            ProviderGuid,
  [in]      PEVENT_DESCRIPTOR EventDescriptor,
  [out]     PTRACE_EVENT_INFO Buffer,
  [in, out] ULONG             *BufferSize
);

Параметры

[in] ProviderGuid

Идентификатор GUID, определяющий поставщика манифеста, метаданные событий которого требуется извлечь.

[in] EventDescriptor

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

[out] Buffer

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

[in, out] BufferSize

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

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

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

Код возврата	Описание
ERROR_EMPTY	В манифесте не определены события для GUID поставщика.
ERROR_FILE_NOT_FOUND	Метаданные для поставщика не найдены.
ERROR_INSUFFICIENT_BUFFER	Размер буфера, на который указывает параметр Buffer , слишком мал. Используйте требуемый размер буфера, заданный в параметре BufferSize , чтобы выделить новый буфер.
ERROR_INVALID_PARAMETER	Один или несколько параметров недопустимы.
ERROR_NOT_FOUND	Сведения о схеме для предоставленного GUID поставщика не найдены.

Требования

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

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

EVENT_DESCRIPTOR

PROVIDER_EVENT_INFO

TRACE_EVENT_INFO

TdhEnumerateManifestProviderEvents

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