Fungsi EvtNext (winevt.h)

Mendapatkan peristiwa berikutnya dari hasil kueri atau langganan.

Sintaks

BOOL EvtNext(
  [in]  EVT_HANDLE  ResultSet,
  [in]  DWORD       EventsSize,
  [in]  PEVT_HANDLE Events,
  [in]  DWORD       Timeout,
  [in]  DWORD       Flags,
  [out] PDWORD      Returned
);

Parameter

[in] ResultSet

Handel ke kueri atau hasil langganan mengatur bahwa fungsi EvtQuery atau fungsi EvtSubscribe kembali.

[in] EventsSize

Jumlah elemen dalam array EventArray . Fungsi ini akan mencoba mengambil jumlah elemen ini dari kumpulan hasil.

[in] Events

Penunjuk ke array handel yang akan diatur ke handel ke peristiwa dari kumpulan hasil.

[in] Timeout

Jumlah milidetik yang bersedia Anda tunggu hasilnya. Atur ke INFINITE untuk menunjukkan tidak ada nilai waktu habis. Jika waktu habis kedaluwarsa, kesalahan terakhir diatur ke ERROR_TIMEOUT.

[in] Flags

Dicadangkan. Harus nol.

[out] Returned

Jumlah handel dalam array yang diatur.

Mengembalikan nilai

Mengembalikan kode/nilai	Deskripsi
TRUE	Fungsi berhasil.
FALSE	Fungsi gagal. Untuk mendapatkan kode kesalahan, panggil fungsi GetLastError .

Keterangan

Panggil fungsi ini dalam perulangan hingga fungsi mengembalikan FALSE dan kode kesalahan ERROR_NO_MORE_ITEMS.

Untuk setiap peristiwa yang Anda ambil, Anda kemudian dapat memanggil fungsi EvtCreateRenderContext dan EvtRender untuk merender peristiwa.

Anda harus memanggil EvtClose pada setiap handel peristiwa yang Anda terima.

Contoh

Untuk contoh yang memperlihatkan cara menggunakan fungsi ini, lihat Mengkueri Peristiwa dan Berlangganan Peristiwa.

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

Lihat juga

EvtQuery

EvtSeek

EvtSubscribe