Fungsi EvtGetObjectArrayProperty (winevt.h)
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 |
---|---|
|
Fungsi berhasil. |
|
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
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk