Bagikan melalui

Fungsi EvtGetPublisherMetadataProperty (winevt.h)

  • Artikel

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