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
| 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) |