Fonction RegisterGPNotification (userenv.h)

La fonction RegisterGPNotification permet à une application de recevoir une notification en cas de modification de stratégie. Lorsqu’une modification de stratégie se produit, l’objet d’événement spécifié est défini sur l’état signalé.

Syntaxe

USERENVAPI BOOL RegisterGPNotification(
  [in] HANDLE hEvent,
  [in] BOOL   bMachine
);

Paramètres

[in] hEvent

Gérez un objet d’événement. Utilisez la fonction CreateEvent pour créer l’objet d’événement.

[in] bMachine

Spécifie le type de modification de stratégie. Si la valeur est TRUE, les modifications de stratégie de l’ordinateur sont signalées. Si la valeur est FALSE, les modifications de stratégie utilisateur sont signalées.

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

Appelez la fonction UnregisterGPNotification pour annuler l’inscription du handle de la réception des notifications de modification de stratégie. Appelez la fonction CloseHandle pour fermer le handle lorsqu’il n’est plus nécessaire.

Une application peut également recevoir des notifications concernant les modifications de stratégie lors de la diffusion d’un message WM_SETTINGCHANGE . Dans cette instance, la valeur du paramètre wParam est 1 si la stratégie ordinateur a été appliquée; elle est égale à zéro si la stratégie utilisateur a été appliquée. Le paramètre lParam pointe vers la chaîne « Policy ».

Configuration requise

Voir aussi

fonctions stratégie de groupe

Vue d’ensemble de la stratégie de groupe

DésinscrireGPNotification