Función NotifyChangeEventLog (winbase.h)

Artículo
03/08/2023

Permite que una aplicación reciba una notificación cuando se escribe un evento en el registro de eventos especificado. Cuando el evento se escribe en el registro, el objeto de evento especificado se establece en el estado señalado.

Sintaxis

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

Parámetros

[in] hEventLog

Identificador de un registro de eventos. La función OpenEventLog devuelve este identificador.

[in] hEvent

Identificador de un objeto de evento de restablecimiento manual o restablecimiento automático. Use la función CreateEvent para crear el objeto de evento.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La función NotifyChangeEventLog no funciona con identificadores remotos. Si el parámetro hEventLog es el identificador de un registro de eventos en un equipo remoto, NotifyChangeEventLog devuelve cero y GetLastError devuelve ERROR_INVALID_HANDLE.

Si el subproceso no espera el evento cuando el sistema llama a PulseEvent, el subproceso no recibirá la notificación. Por lo tanto, debe crear un subproceso independiente para esperar notificaciones.

El sistema seguirá notificándolo de los cambios hasta que cierre el identificador en el registro de eventos. Para cerrar el registro de eventos, use la función CloseEventLog o DeregisterEventSource .

Ejemplos

Para obtener un ejemplo, consulte Recepción de notificaciones de eventos.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winbase.h (incluya Windows.h)
Library	Advapi32.lib
Archivo DLL	Advapi32.dll
Conjunto de API	ext-ms-win-advapi32-eventlog-l1-1-1 (introducido en Windows 10, versión 10.0.10240)