Fungsi EvtGetObjectArrayProperty (winevt.h)

Artikel
08/27/2023

Mendapatkan properti metadata penyedia dari objek yang ditentukan dalam array.

Sintaks

BOOL EvtGetObjectArrayProperty(
  [in]  EVT_OBJECT_ARRAY_PROPERTY_HANDLE ObjectArray,
  [in]  DWORD                            PropertyId,
  [in]  DWORD                            ArrayIndex,
  [in]  DWORD                            Flags,
  [in]  DWORD                            PropertyValueBufferSize,
  [in]  PEVT_VARIANT                     PropertyValueBuffer,
  [out] PDWORD                           PropertyValueBufferUsed
);

Parameter

[in] ObjectArray

Handel ke array objek yang dikembalikan fungsi EvtGetPublisherMetadataProperty .

[in] PropertyId

Pengidentifikasi properti properti metadata yang ingin Anda dapatkan dari objek yang ditentukan. Untuk nilai yang mungkin, lihat bagian Keterangan dari EVT_PUBLISHER_METADATA_PROPERTY_ID.

[in] ArrayIndex

Indeks berbasis nol objek dalam array.

[in] Flags

Dicadangkan. Harus nol.

[in] PropertyValueBufferSize

Ukuran buffer PropertyValueBuffer , dalam byte.

[in] PropertyValueBuffer

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] PropertyValueBufferUsed

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

Saat Anda memanggil fungsi EvtGetPublisherMetadataProperty dengan ID berikut, fungsi mengembalikan handel ke array objek jenis tersebut:

EvtPublisherMetadataChannelReferences
EvtPublisherMetadataLevels
EvtPublisherMetadataTasks
EvtPublisherMetadataOpcodes
EvtPublisherMetadataKeywords

Misalnya, jika Anda meneruskan EvtPublisherMetadataKeywords ke EvtGetPublisherMetadataProperty, fungsi mengembalikan handel ke array objek kata kunci.

Untuk menentukan ukuran array, panggil fungsi EvtGetObjectArraySize .

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

EVT_PUBLISHER_METADATA_PROPERTY_ID

EvtGetPublisherMetadataProperty

Bagikan melalui