Operações de log de eventos
O OpenEventLog, OpenBackupEventLog, RegisterEventSource, DeregisterEventSourcee CloseEventLog funções abrir e fechar identificadores de log de eventos.
A tabela a seguir mostra as operações que podem ser executadas em um log de eventos aberto e a função correspondente para cada operação.
| Funcionamento | Função |
|---|---|
| Backup | BackupEventLog |
| Limpar | ClearEventLog |
| Monitorização | NotifyChangeEventLog |
| Consulta | GetOldestEventLogRecord GetNumberOfEventLogRecords |
| Ler | ReadEventLog |
| Escrever | ReportEvent |
As funções OpenEventLog e ReportEvent usam um nome de servidor opcional como parâmetro para que as operações possam ser executadas no servidor remoto. Use OpenEventLog para ler ou executar operações administrativas (backup, clear, monitor e query) no log e use RegisterEventSource para gravar no log.
Cada chamada para uma função de log de eventos é uma operação atômica. Quando você lê o log de eventos, somente registros de eventos inteiros são retornados. Quando você grava no log de eventos, cada registro de evento tem a garantia de ser gravado sequencialmente como um registro completo no log. A lista a seguir descreve como o serviço de log de eventos lida com condições especiais:
- O serviço de log de eventos recebe uma operação de leitura e uma operação de gravação ao mesmo tempo: se a posição de leitura estiver no final do arquivo, a operação de leitura falhará com um status de "fim de arquivo" (se a operação de gravação não tiver sido concluída) ou retornará o novo registro (se a operação de gravação tiver sido concluída).
- O serviço de log de eventos conclui uma operação clara antes de receber uma operação de leitura: a operação de leitura falha com o status de "fim de arquivo".
- O serviço de log de eventos conclui uma operação clara antes de receber uma operação de gravação: a operação de limpeza trunca o log e, em seguida, a operação de gravação adiciona o novo registro no início do log.