Fungsi EvtGetPublisherMetadataProperty (winevt.h)

Artikel
08/27/2023

Mendapatkan properti metadata penyedia yang ditentukan.

Sintaks

BOOL EvtGetPublisherMetadataProperty(
  [in]  EVT_HANDLE                         PublisherMetadata,
  [in]  EVT_PUBLISHER_METADATA_PROPERTY_ID PropertyId,
  [in]  DWORD                              Flags,
  [in]  DWORD                              PublisherMetadataPropertyBufferSize,
  [in]  PEVT_VARIANT                       PublisherMetadataPropertyBuffer,
  [out] PDWORD                             PublisherMetadataPropertyBufferUsed
);

Parameter

[in] PublisherMetadata

Handel ke metadata yang dikembalikan fungsi EvtOpenPublisherMetadata .

[in] PropertyId

Pengidentifikasi properti metadata untuk diambil. Untuk daftar pengidentifikasi properti, lihat enumerasi EVT_PUBLISHER_METADATA_PROPERTY_ID .

[in] Flags

Dicadangkan. Harus nol.

[in] PublisherMetadataPropertyBufferSize

Ukuran buffer PublisherMetadataPropertyBuffer , dalam byte.

[in] PublisherMetadataPropertyBuffer

Buffer yang dialokasikan penelepon yang akan menerima properti metadata. Buffer berisi objek EVT_VARIANT . Anda dapat mengatur parameter ini ke NULL untuk menentukan ukuran buffer yang diperlukan.

[out] PublisherMetadataPropertyBufferUsed

Ukuran, dalam byte, dari buffer yang dialokasikan pemanggil yang digunakan fungsi atau ukuran buffer yang diperlukan jika fungsi gagal dengan ERROR_INSUFFICIENT_BUFFER.

Mengembalikan nilai

Mengembalikan kode/nilai	Deskripsi
TRUE	Fungsi berhasil.
FALSE	Fungsi gagal. Untuk mendapatkan kode kesalahan, panggil fungsi GetLastError .

Keterangan

Perhatian

EvtGetEventMetadataProperty dapat mengembalikan berbagai jenis nilai dalam variabel EventMetadataPropertyBuffer . Jika EventMetadataPropertyBuffer-Type> == EvtVarTypeEvtHandle maka EventMetadataPropertyBuffer berisi handel yang perlu dibebaskan. Ketika Anda selesai dengan handel, panggil fungsi EvtClose .

Contoh

Untuk contoh yang memperlihatkan cara menggunakan fungsi ini, lihat Mendapatkan Metadata Penyedia.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	winevt.h
Pustaka	Wevtapi.lib
DLL	Wevtapi.dll

Lihat juga

EvtOpenPublisherMetadata

Bagikan melalui