Fungsi ReadEventLogA (winbase.h)
Membaca jumlah entri yang ditentukan dari log peristiwa yang ditentukan. Fungsi ini dapat digunakan untuk membaca entri log dalam urutan kronologis kronologis atau terbalik.
Sintaks
BOOL ReadEventLogA(
[in] HANDLE hEventLog,
[in] DWORD dwReadFlags,
[in] DWORD dwRecordOffset,
[out] LPVOID lpBuffer,
[in] DWORD nNumberOfBytesToRead,
[out] DWORD *pnBytesRead,
[out] DWORD *pnMinNumberOfBytesNeeded
);
Parameter
[in] hEventLog
Handel ke log peristiwa yang akan dibaca. Fungsi OpenEventLog mengembalikan handel ini.
[in] dwReadFlags
Gunakan nilai bendera berikut untuk menunjukkan cara membaca file log. Parameter ini harus menyertakan salah satu nilai berikut (bendera saling eksklusif).
Anda harus menentukan salah satu bendera berikut untuk menunjukkan arah operasi baca berturut-turut (bendera saling eksklusif).
[in] dwRecordOffset
Nomor rekaman entri log di mana operasi baca harus dimulai. Parameter ini diabaikan kecuali dwReadFlags menyertakan bendera EVENTLOG_SEEK_READ .
[out] lpBuffer
Buffer yang dialokasikan aplikasi yang akan menerima satu atau beberapa struktur EVENTLOGRECORD . Parameter ini tidak boleh NULL, meskipun parameter nNumberOfBytesToRead adalah nol.
Ukuran maksimum buffer ini adalah 0x7ffff byte.
[in] nNumberOfBytesToRead
Ukuran buffer lpBuffer , dalam byte. Fungsi ini akan membaca entri log sebanyak yang akan muat dalam buffer; fungsi tidak akan mengembalikan entri parsial.
[out] pnBytesRead
Penunjuk ke variabel yang menerima jumlah byte yang dibaca oleh fungsi.
[out] pnMinNumberOfBytesNeeded
Penunjuk ke variabel yang menerima ukuran buffer lpBuffer yang diperlukan. Nilai ini hanya valid jika fungsi ini mengembalikan nol dan GetLastError mengembalikan ERROR_INSUFFICIENT_BUFFER.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Ketika fungsi ini berhasil dikembalikan, posisi baca dalam log peristiwa disesuaikan dengan jumlah rekaman yang dibaca.
Contoh
Misalnya, lihat Mengkueri informasi peristiwa.
Catatan
Header winbase.h mendefinisikan ReadEventLog sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
Target Platform | Windows |
Header | winbase.h (termasuk Windows.h) |
Pustaka | Advapi32.lib |
DLL | Advapi32.dll |
Set API | ext-ms-win-advapi32-eventlog-ansi-l1-1-0 (diperkenalkan dalam Windows 10, versi 10.0.10240) |
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