Bewerkingen voor gebeurtenislogboeken
De OpenEventLog, OpenBackupEventLog, RegisterEventSource, DeregisterEventSourceen CloseEventLog--functies worden geopend en gesloten.
In de volgende tabel ziet u de bewerkingen die kunnen worden uitgevoerd in een geopend gebeurtenislogboek en de bijbehorende functie voor elke bewerking.
Operatie | Functie |
---|---|
Backup | BackupEventLog- |
Duidelijk | ClearEventLog- |
Monitor | NotifyChangeEventLog- |
Vraag | GetOldestEventLogRecord, GetNumberOfEventLogRecords |
Lezen | ReadEventLog- |
Schrijven | ReportEvent- |
De functies OpenEventLog en ReportEvent gebruiken een optionele servernaam als parameter, zodat de bewerkingen op de externe server kunnen worden uitgevoerd. Gebruik OpenEventLog- voor het lezen of uitvoeren van beheerbewerkingen (back-up, wissen, bewaken en query's) in het logboek en gebruik RegisterEventSource- voor het schrijven naar het logboek.
Elke aanroep naar een functie voor gebeurtenislogboekregistratie is een atomische bewerking. Wanneer u het gebeurtenislogboek leest, worden alleen hele gebeurtenisrecords geretourneerd. Wanneer u naar het gebeurtenislogboek schrijft, wordt gegarandeerd dat elke gebeurtenisrecord opeenvolgend als een volledige record in het logboek wordt geschreven. In de volgende lijst wordt beschreven hoe de service voor gebeurtenislogboekregistratie speciale voorwaarden verwerkt:
- De service voor gebeurtenislogboekregistratie ontvangt een leesbewerking en een schrijfbewerking tegelijk: als de leespositie zich aan het einde van het bestand bevindt, mislukt de leesbewerking met de status 'einde van bestand' (als de schrijfbewerking niet is voltooid) of wordt de nieuwe record geretourneerd (als de schrijfbewerking is voltooid).
- De gebeurtenisregistratieservice voltooit een duidelijke bewerking voordat een leesbewerking wordt ontvangen: de leesbewerking mislukt met de status 'einde van bestand'.
- De service voor gebeurtenislogboekregistratie voltooit een duidelijke bewerking voordat een schrijfbewerking wordt ontvangen: met de clear-bewerking wordt het logboek afgekapt en wordt de nieuwe record aan het begin van het logboek toegevoegd door de schrijfbewerking.