Fungsi EvtGetEventInfo (winevt.h)

Artikel
08/27/2023

Mendapatkan informasi yang mengidentifikasi kueri XML terstruktur yang memilih peristiwa dan saluran atau file log yang berisi peristiwa.

Sintaks

BOOL EvtGetEventInfo(
  [in]  EVT_HANDLE            Event,
  [in]  EVT_EVENT_PROPERTY_ID PropertyId,
  [in]  DWORD                 PropertyValueBufferSize,
  [in]  PEVT_VARIANT          PropertyValueBuffer,
  [out] PDWORD                PropertyValueBufferUsed
);

Parameter

[in] Event

Handel ke peristiwa yang ingin Anda ambil informasinya.

[in] PropertyId

Bendera yang mengidentifikasi informasi yang akan diambil. Misalnya, pengidentifikasi kueri atau jalur. Untuk nilai yang mungkin, lihat enumerasi EVT_EVENT_PROPERTY_ID .

[in] PropertyValueBufferSize

Ukuran buffer PropertyValueBuffer , dalam byte.

[in] PropertyValueBuffer

Buffer yang dialokasikan penelepon yang akan menerima informasi. 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. Gunakan fungsi GetLastError untuk mendapatkan kode kesalahan.

Keterangan

Jika kueri yang Anda berikan ke EvtQuery atau EvtSubscribe adalah JalurX alih-alih kueri XML terstruktur, pengidentifikasi kueri akan menjadi nol dan jalur akan menjadi jalur yang Anda berikan ke fungsi.

Persyaratan


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

Bagikan melalui