Функция EvtGetEventMetadataProperty (winevt.h)

Статья
03/13/2024

Возвращает указанное свойство метаданных события.

Синтаксис

BOOL EvtGetEventMetadataProperty(
  [in]  EVT_HANDLE                     EventMetadata,
  [in]  EVT_EVENT_METADATA_PROPERTY_ID PropertyId,
  [in]  DWORD                          Flags,
  [in]  DWORD                          EventMetadataPropertyBufferSize,
  [in]  PEVT_VARIANT                   EventMetadataPropertyBuffer,
  [out] PDWORD                         EventMetadataPropertyBufferUsed
);

Параметры

[in] EventMetadata

Дескриптор метаданных события, возвращаемых функцией EvtNextEventMetadata .

[in] PropertyId

Идентификатор извлекаемого свойства метаданных. Список идентификаторов свойств см. в перечислении EVT_EVENT_METADATA_PROPERTY_ID .

[in] Flags

Зарезервировано. Должен равняться нулю.

[in] EventMetadataPropertyBufferSize

Размер буфера EventMetadataPropertyBuffer в байтах.

[in] EventMetadataPropertyBuffer

Буфер, выделенный вызывающим объектом, который получит свойство метаданных. Буфер содержит объект EVT_VARIANT . Для этого параметра можно задать значение NULL , чтобы определить требуемый размер буфера.

[out] EventMetadataPropertyBufferUsed

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

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

Возвращаемый код или значение	Описание
TRUE	Функция выполнена успешно.
FALSE	Сбой функции. Чтобы получить код ошибки, вызовите функцию GetLastError .

Требования

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

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

EvtGetPublisherMetadataProperty

EvtNextEventMetadata

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