Eseménynaplózási műveletek
Az OpenEventLog, OpenBackupEventLog, RegisterEventSource, DeregisterEventSource, és CloseEventLog függvények megnyitják és bezárják az eseménynapló-leírókat.
Az alábbi táblázat a megnyitott eseménynaplókon végrehajtható műveleteket és az egyes műveletek megfelelő függvényét mutatja be.
| Művelet | Funkció |
|---|---|
| Biztonsági mentés | BackupEventLog |
| Világos | ClearEventLog |
| Monitor | NotifyChangeEventLog |
| Lekérdezés | GetOldestEventLogRecord, GetNumberOfEventLogRecords |
| Olvas | ReadEventLog |
| Ír | ReportEvent |
Az OpenEventLog és ReportEvent függvény paraméterként opcionális kiszolgálónevet vesz fel, így a műveletek végrehajthatók a távoli kiszolgálón. Az OpenEventLog használatával elolvashatja vagy végrehajthatja a naplón a felügyeleti műveleteket (biztonsági mentés, törlés, monitorozás és lekérdezés), és RegisterEventSource használatával írhat a naplóba.
Az eseménynaplózási függvény minden hívása atomi művelet. Amikor az eseménynaplóból olvas, a rendszer csak teljes eseményrekordokat ad vissza. Amikor az eseménynaplóba ír, az egyes eseményrekordok garantáltan egymás után lesznek megírva teljes rekordként a naplóban. Az alábbi lista bemutatja, hogyan kezeli az eseménynaplózási szolgáltatás a különleges feltételeket:
- Az eseménynaplózási szolgáltatás egyszerre kap olvasási és írási műveletet: Ha az olvasási pozíció a fájl végén van, az olvasási művelet "a fájl vége" állapottal meghiúsul (ha az írási művelet nem fejeződött be), vagy az új rekordot adja vissza (ha az írási művelet befejeződött).
- Az eseménynaplózási szolgáltatás az olvasási művelet fogadása előtt egy egyértelmű műveletet hajt végre: Az olvasási művelet "fájlvégi" állapottal meghiúsul.
- Az eseménynaplózási szolgáltatás egy írási művelet fogadása előtt befejez egy egyértelmű műveletet: A törlési művelet csonkolja a naplót, majd az írási művelet hozzáadja az új rekordot a napló elején.