Fungsi EvtGetQueryInfo (winevt.h)

Artikel
08/27/2023

Mendapatkan informasi tentang kueri yang Anda jalankan yang mengidentifikasi daftar saluran atau file log yang coba diakses kueri. Fungsi ini juga mendapatkan daftar kode pengembalian yang menunjukkan keberhasilan atau kegagalan setiap akses.

Sintaks

BOOL EvtGetQueryInfo(
  [in]  EVT_HANDLE            QueryOrSubscription,
  [in]  EVT_QUERY_PROPERTY_ID PropertyId,
  [in]  DWORD                 PropertyValueBufferSize,
  [in]  PEVT_VARIANT          PropertyValueBuffer,
  [out] PDWORD                PropertyValueBufferUsed
);

Parameter

[in] QueryOrSubscription

Handel ke kueri yang dikembalikan fungsiEvtQuery atau EvtSubscribe .

[in] PropertyId

Pengidentifikasi informasi kueri yang akan diambil. Untuk daftar pengidentifikasi, lihat enumerasi EVT_QUERY_PROPERTY_ID .

[in] PropertyValueBufferSize

Ukuran buffer PropertyValueBuffer , dalam byte.

[in] PropertyValueBuffer

Buffer yang dialokasikan penelepon yang akan menerima informasi kueri. 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

Anda hanya perlu memanggil fungsi ini, jika Anda meneruskan bendera EvtQueryTolerateQueryErrors ke EvtQuery atau bendera EvtSubscribeTolerateQueryErrors ke EvtSubscribe.

Contoh

Untuk contoh yang memperlihatkan cara menggunakan fungsi ini, lihat Mengkueri peristiwa.

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

EvtQuery

EvtSubscribe

Bagikan melalui