Funzione NotifyChangeEventLog (winbase.h)

Consente a un'applicazione di ricevere una notifica quando un evento viene scritto nel registro eventi specificato. Quando l'evento viene scritto nel log, l'oggetto evento specificato viene impostato sullo stato segnalato.

Sintassi

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

Parametri

[in] hEventLog

Handle di un registro eventi. La funzione OpenEventLog restituisce questo handle.

[in] hEvent

Handle per un oggetto evento di reimpostazione manuale o reimpostazione automatica. Utilizzare la funzione CreateEvent per creare l'oggetto evento.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione NotifyChangeEventLog non funziona con handle remoti. Se il parametro hEventLog è l'handle di un registro eventi in un computer remoto, NotifyChangeEventLog restituisce zero e GetLastError restituisce ERROR_INVALID_HANDLE.

Se il thread non è in attesa dell'evento quando il sistema chiama PulseEvent, il thread non riceverà la notifica. Pertanto, è necessario creare un thread separato per attendere le notifiche.

Il sistema continuerà a notificare le modifiche fino a quando non si chiude l'handle al registro eventi. Per chiudere il registro eventi, usare la funzione CloseEventLog o DeregisterEventSource .

Esempio

Per un esempio, vedere Ricezione di notifiche degli eventi.

Requisiti

Vedi anche

CloseEventLog

CreateEvent

DeregisterEventSource

Funzioni di registrazione eventi

OpenEventLog