Função NotifyChangeEventLog (winbase.h)

Permite que um aplicativo receba uma notificação quando um evento é gravado no log de eventos especificado. Quando o evento é gravado no log, o objeto de evento especificado é definido como o estado sinalizado.

Sintaxe

BOOL NotifyChangeEventLog(
  [in] HANDLE hEventLog,
  [in] HANDLE hEvent
);

Parâmetros

[in] hEventLog

Um identificador para um log de eventos. A função OpenEventLog retorna esse identificador.

[in] hEvent

Um identificador para um objeto de evento de redefinição manual ou redefinição automática. Use a função CreateEvent para criar o objeto de evento.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A função NotifyChangeEventLog não funciona com identificadores remotos. Se o parâmetro hEventLog for o identificador de um log de eventos em um computador remoto, NotifyChangeEventLog retornará zero e GetLastError retornará ERROR_INVALID_HANDLE.

Se o thread não estiver aguardando o evento quando o sistema chamar PulseEvent, o thread não receberá a notificação. Portanto, você deve criar um thread separado para aguardar as notificações.

O sistema continuará notificando você sobre as alterações até que você feche o identificador do log de eventos. Para fechar o log de eventos, use a função CloseEventLog ou DeregisterEventSource .

Exemplos

Para obter um exemplo, consulte Recebendo notificação de evento.

Requisitos

Confira também

CloseEventLog

CreateEvent

DeregisterEventSource

Funções de log de eventos

OpenEventLog