Operações de log de eventos

As funções OpenEventLog, OpenBackupEventLog, RegisterEventSource, DeregisterEventSource e CloseEventLog abrem 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.

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, monitoramento e consulta) 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ê do log de eventos, somente registros de eventos inteiros são retornados. Quando você grava no log de eventos, é garantido que cada registro de evento seja 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 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 log de eventos conclui uma operação clara antes de receber uma operação de leitura: a operação de leitura falha com status "fim do 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.