Operasi Pengelogan Peristiwa
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 |
|---|---|
| Cadangan | 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.