Função NotifyChangeEventLog (winbase.h)

Artigo
08/27/2023

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

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winbase.h (incluir Windows.h)
Biblioteca	Advapi32.lib
DLL	Advapi32.dll
Conjunto de APIs	ext-ms-win-advapi32-eventlog-l1-1-1 (introduzido no Windows 10, versão 10.0.10240)