Операции ведения журнала событий
OpenEventLog, OpenBackupEventLog, RegisterEventSource, DeregisterEventSourceи Функции CloseEventLog открыты и закрываются.
В следующей таблице показаны операции, которые можно выполнять в открытом журнале событий и соответствующую функцию для каждой операции.
| Операция | Функция |
|---|---|
| Резервная копия | BackupEventLog |
| Ясный | ClearEventLog |
| Монитор | NotifyChangeEventLog |
| Запрос | GetOldestEventLogRecord, GetNumberOfEventLogRecords |
| Читать | ReadEventLog |
| Писать | ReportEvent |
Функции OpenEventLog и ReportEvent принимают необязательное имя сервера в качестве параметра, чтобы операции могли выполняться на удаленном сервере. Используйте OpenEventLog для чтения или выполнения административных операций (резервного копирования, очистки, мониторинга и запроса) в журнале и использования RegisterEventSource для записи в журнал.
Каждый вызов функции ведения журнала событий является атомарной операцией. При чтении из журнала событий возвращаются только все записи событий. При записи в журнал событий каждая запись событий гарантированно записывается последовательно в виде полной записи в журнале. В следующем списке описывается, как служба ведения журнала событий обрабатывает специальные условия:
- Служба ведения журнала событий получает операцию чтения и операцию записи одновременно: если позиция чтения находится в конце файла, операция чтения завершается сбоем с состоянием завершения операции чтения (если операция записи не завершена), или она возвращает новую запись (если операция записи завершена).
- Служба ведения журнала событий завершает четкую операцию перед получением операции чтения: операция чтения завершается сбоем с состоянием завершения файла.
- Служба ведения журнала событий завершает четкую операцию перед получением операции записи: операция очистки усечена журнала, а затем операция записи добавляет новую запись в начале журнала.