Operações de log de eventos

As funções OpenEventLog, OpenBackupEventLog, RegisterEventSource, DeregisterEventSourcee closeEventLog funções abertas e fecham 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.

Operação	Função
Backup	BackupEventLog
Claro	ClearEventLog
Monitor	NotifyChangeEventLog
Consulta	GetOldestEventLogRecord, GetNumberOfEventLogRecords
Ler	ReadEventLog
Escrever	ReportEvent

 

As funções OpenEventLog e ReportEvent assumem um nome de servidor opcional como um parâmetro para que as operações possam ser executadas no servidor remoto. Use OpenEventLog para ler ou executar operações administrativas (backup, limpeza, monitor e consulta) no log e usar RegisterEventSource para gravar no log.

Cada chamada para uma função de registro em log de eventos é uma operação atômica. Quando você lê do log de eventos, apenas 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 registro em log de eventos lida com condições especiais:

• O serviço de registro em 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 do 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 registro em 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 "fim do arquivo".
• O serviço de registro em 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.