Partager via


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)

Voir aussi

CloseEventLog

CreateEvent

DeregisterEventSource

Fonctions de journalisation des événements

OpenEventLog