Fonction NotifyChangeEventLog (winbase.h)
Permet à une application de recevoir une notification lorsqu’un événement est écrit dans le journal des événements spécifié. Lorsque l’événement est écrit dans le journal, l’objet d’événement spécifié est défini sur l’état signalé.
Syntaxe
BOOL NotifyChangeEventLog(
[in] HANDLE hEventLog,
[in] HANDLE hEvent
);
Paramètres
[in] hEventLog
Handle dans un journal des événements. La fonction OpenEventLog retourne ce handle.
[in] hEvent
Handle d’un objet d’événement de réinitialisation manuelle ou de réinitialisation automatique. Utilisez la fonction CreateEvent pour créer l’objet d’événement.
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
La fonction NotifyChangeEventLog ne fonctionne pas avec les handles distants. Si le paramètre hEventLog est le handle d’un journal d’événements sur un ordinateur distant, NotifyChangeEventLog retourne zéro et GetLastError retourne ERROR_INVALID_HANDLE.
Si le thread n’attend pas l’événement lorsque le système appelle PulseEvent, le thread ne reçoit pas la notification. Par conséquent, vous devez créer un thread distinct pour attendre les notifications.
Le système continue de vous informer des modifications jusqu’à ce que vous fermiez le handle dans le journal des événements. Pour fermer le journal des événements, utilisez la fonction CloseEventLog ou DeregisterEventSource .
Exemples
Pour obtenir un exemple, consultez Réception d’une notification d’événement.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | winbase.h (inclure Windows.h) |
| Bibliothèque | Advapi32.lib |
| DLL | Advapi32.dll |
| Ensemble d’API | ext-ms-win-advapi32-eventlog-l1-1-1 (introduit dans Windows 10, version 10.0.10240) |