Operacje rejestrowania zdarzeń

OpenEventLog, OpenBackupEventLog, RegisterEventSource, DeregisterEventSourcei CloseEventLog otwarte i zamykają dojścia dziennika zdarzeń.

W poniższej tabeli przedstawiono operacje, które można wykonać w otwartym dzienniku zdarzeń oraz odpowiednią funkcję dla każdej operacji.

Funkcje OpenEventLog i ReportEvent przyjmują opcjonalną nazwę serwera jako parametr, aby można było wykonywać operacje na serwerze zdalnym. Użyj OpenEventLog do odczytywania lub wykonywania operacji administracyjnych (tworzenia kopii zapasowej, czyszczenia, monitorowania i wykonywania zapytań) w dzienniku oraz używania RegisterEventSource do zapisywania w dzienniku.

Każde wywołanie funkcji rejestrowania zdarzeń to operacja niepodzielna. Podczas odczytywania z dziennika zdarzeń zwracane są tylko całe rekordy zdarzeń. Podczas zapisywania w dzienniku zdarzeń każdy rekord zdarzenia musi być zapisywany sekwencyjnie jako pełny rekord w dzienniku. Poniższa lista zawiera opis sposobu obsługi specjalnych warunków przez usługę rejestrowania zdarzeń:

• Usługa rejestrowania zdarzeń odbiera operację odczytu i operację zapisu w tym samym czasie: jeśli pozycja odczytu znajduje się na końcu pliku, operacja odczytu kończy się niepowodzeniem ze stanem "koniec pliku" (jeśli operacja zapisu nie została ukończona) lub zwraca nowy rekord (jeśli operacja zapisu została ukończona).
• Usługa rejestrowania zdarzeń kończy operację czyszczenia przed otrzymaniem operacji odczytu: operacja odczytu kończy się niepowodzeniem ze stanem "end-of-file".
• Usługa rejestrowania zdarzeń kończy operację czyszczenia przed otrzymaniem operacji zapisu: Operacja czyszczenia obcina dziennik, a następnie operacja zapisu dodaje nowy rekord na początku dziennika.