Operace protokolování událostí

OpenEventLog, OpenBackupEventLog, RegisterEventSource, DeregisterEventSourcea CloseEventLog funkce otevření a zavření popisovačů protokolu událostí.

Následující tabulka uvádí operace, které je možné provést v otevřeném protokolu událostí, a odpovídající funkci pro každou operaci.

Funkce OpenEventLog a ReportEvent jako parametr přebírají volitelný název serveru, aby bylo možné provádět operace na vzdáleném serveru. OpenEventLog ke čtení nebo provádění operací správy (zálohování, vymazání, monitorování a dotaz) v protokolu a k zápisu do protokolu použijte RegisterEventSource.

Každé volání funkce protokolování událostí je atomická operace. Při čtení z protokolu událostí se vrátí pouze celé záznamy událostí. Při zápisu do protokolu událostí je zaručeno, že každý záznam události bude zapsán postupně jako úplný záznam v protokolu. Následující seznam popisuje, jak služba protokolování událostí zpracovává zvláštní podmínky:

• Služba protokolování událostí obdrží operaci čtení a operaci zápisu současně: Pokud je pozice čtení na konci souboru, operace čtení selže se stavem "end-of-file" (pokud operace zápisu nebyla dokončena), nebo vrátí nový záznam (pokud byla operace zápisu dokončena).
• Služba protokolování událostí dokončí jasnou operaci před přijetím operace čtení: Operace čtení selže se stavem konec souboru.
• Služba protokolování událostí dokončí jasnou operaci před přijetím operace zápisu: Operace vymazání zkrátí protokol a pak operace zápisu přidá nový záznam na začátek protokolu.