Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Observação
A API de Log de Eventos foi projetada para aplicativos executados no sistema operacional Windows Server 2003, Windows XP ou Windows 2000. No Windows Vista, a infraestrutura de registro em log de eventos foi reprojetada. Os aplicativos projetados para serem executados no Windows Vista ou em sistemas operacionais posteriores agora devem usar o Log de Eventos do Windows.
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.