Händelseloggningsåtgärder
Funktionerna OpenEventLog, OpenBackupEventLog, RegisterEventSource, DeregisterEventSourceoch CloseEventLog funktioner öppna och stänga händelseloggreferenser.
I följande tabell visas de åtgärder som kan utföras i en öppen händelselogg och motsvarande funktion för varje åtgärd.
Operation | Funktion |
---|---|
Säkerhetskopia | BackupEventLog |
Klar | ClearEventLog |
Bildskärm | NotifyChangeEventLog |
Fråga | GetOldestEventLogRecord, GetNumberOfEventLogRecords |
Läsa | ReadEventLog |
Skriva | ReportEvent |
Funktionerna OpenEventLog och ReportEvent har ett valfritt servernamn som parameter så att åtgärderna kan utföras på fjärrservern. Använd OpenEventLog- för att läsa eller utföra administrativa åtgärder (säkerhetskopiering, rensa, övervaka och fråga) i loggen och använd RegisterEventSource- för att skriva till loggen.
Varje anrop till en händelseloggningsfunktion är en atomisk åtgärd. När du läser från händelseloggen returneras endast hela händelseposter. När du skriver till händelseloggen kommer varje händelsepost garanterat att skrivas sekventiellt som en fullständig post i loggen. I följande lista beskrivs hur tjänsten för händelseloggning hanterar särskilda villkor:
- Tjänsten för händelseloggning tar emot en läsåtgärd och en skrivåtgärd samtidigt: Om läspositionen är i slutet av filen misslyckas antingen läsåtgärden med statusen "filslut" (om skrivåtgärden inte har slutförts) eller returnerar den nya posten (om skrivåtgärden har slutförts).
- Tjänsten för händelseloggning slutför en tydlig åtgärd innan en läsåtgärd tas emot: Läsåtgärden misslyckas med statusen "filslut".
- Tjänsten för händelseloggning slutför en tydlig åtgärd innan en skrivåtgärd tas emot: Clear-åtgärden trunkerar loggen och sedan lägger skrivåtgärden till den nya posten i början av loggen.