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