Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Nota
API Pengelogan Peristiwa dirancang untuk aplikasi yang berjalan pada sistem operasi Windows Server 2003, Windows XP, atau Windows 2000. Di Windows Vista, infrastruktur pengelogan peristiwa didesain ulang. Aplikasi yang dirancang untuk berjalan pada Windows Vista atau sistem operasi yang lebih baru sekarang harus menggunakan Log Peristiwa Windows.
OpenEventLog, OpenBackupEventLog, RegisterEventSource, DeregisterEventSource, dan fungsiCloseEventLogmembuka dan menutup handel log peristiwa.
Tabel berikut ini memperlihatkan operasi yang dapat dilakukan pada log peristiwa terbuka, dan fungsi yang sesuai untuk setiap operasi.
| Operasi | Fungsi |
|---|---|
| Backup | backupEventLog |
| Jelas | ClearEventLog |
| Monitor | NotifyChangeEventLog |
| Kueri | GetOldestEventLogRecord, GetNumberOfEventLogRecords |
| Membaca | ReadEventLog |
| Menulis | ReportEvent |
Fungsi OpenEventLog dan ReportEvent mengambil nama server opsional sebagai parameter sehingga operasi dapat dilakukan di server jarak jauh. Gunakan OpenEventLog untuk membaca atau melakukan operasi administratif (pencadangan, hapus, pantau, dan kueri) pada log, dan gunakan RegisterEventSource untuk menulis ke log.
Setiap panggilan ke fungsi pengelogan peristiwa adalah operasi atomik. Saat Anda membaca dari log peristiwa, hanya seluruh rekaman peristiwa yang dikembalikan. Saat Anda menulis ke log peristiwa, setiap rekaman peristiwa dijamin ditulis secara berurutan sebagai catatan lengkap dalam log. Daftar berikut ini menjelaskan bagaimana layanan pengelogan peristiwa menangani kondisi khusus:
- Layanan pengelogan peristiwa menerima operasi baca dan operasi tulis pada saat yang sama: Jika posisi baca berada di akhir file, operasi baca gagal dengan status "akhir file" (jika operasi tulis belum selesai), atau mengembalikan rekaman baru (jika operasi tulis telah selesai).
- Layanan pengelogan peristiwa menyelesaikan operasi yang jelas sebelum menerima operasi baca: Operasi baca gagal dengan status "akhir file".
- Layanan pengelogan peristiwa menyelesaikan operasi yang jelas sebelum menerima operasi tulis: Operasi yang jelas memotong log, lalu operasi tulis menambahkan catatan baru di awal log.