Fonction NotifyChangeEventLog (winbase.h)

Article
03/03/2024

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)