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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winbase.h (include Windows.h) |
| Libreria | Advapi32.lib |
| DLL | Advapi32.dll |
| Set di API | ext-ms-win-advapi32-eventlog-l1-1-1 (introdotto in Windows 10, versione 10.0.10240) |