Partager via


WM_SETTINGCHANGE message

Message envoyé à toutes les fenêtres de niveau supérieur lorsque la fonction SystemParametersInfo modifie un paramètre à l’échelle du système ou lorsque les paramètres de stratégie ont changé.

Les applications doivent envoyer des WM_SETTINGCHANGE à toutes les fenêtres de niveau supérieur lorsqu’elles apportent des modifications aux paramètres système. (Ce message ne peut pas être envoyé directement à une fenêtre.) Pour envoyer le message WM_SETTINGCHANGE à toutes les fenêtres de niveau supérieur, utilisez la fonction SendMessageTimeout avec le paramètre hwnd défini sur HWND_BROADCAST.

Une fenêtre reçoit ce message via sa fonction WindowProc.

#define WM_WININICHANGE                 0x001A
#define WM_SETTINGCHANGE                WM_WININICHANGE

Paramètres

wParam

Lorsque le système envoie ce message à la suite d’un appel SystemParametersInfo , le paramètre wParam est la valeur du paramètre uiAction passé à la fonction SystemParametersInfo . Pour obtenir la liste des valeurs, consultez SystemParametersInfo.

Lorsque le système envoie ce message à la suite d’une modification des paramètres de stratégie, ce paramètre indique le type de stratégie qui a été appliqué. Cette valeur est 1 si la stratégie d’ordinateur a été appliquée ou zéro si la stratégie utilisateur a été appliquée.

Lorsque le système envoie ce message à la suite d’une modification des paramètres régionaux, ce paramètre est égal à zéro.

Lorsqu’une application envoie ce message, ce paramètre doit être NULL.

lParam

Lorsque le système envoie ce message à la suite d’un appel SystemParametersInfo , lParam est un pointeur vers une chaîne qui indique la zone contenant le paramètre système qui a été modifié. Ce paramètre n’indique généralement pas quel paramètre système spécifique a changé. (Notez que certaines applications envoient ce message avec lParam défini sur NULL.) En général, lorsque vous recevez ce message, vous devez case activée et recharger tous les paramètres système utilisés par votre application.

Cette chaîne peut être le nom d’une clé de Registre ou le nom d’une section dans le fichier Win.ini. Lorsque la chaîne est un nom de registre, elle indique généralement uniquement le nœud feuille dans le registre, et non le chemin d’accès complet.

Lorsque le système envoie ce message à la suite d’une modification des paramètres de stratégie, ce paramètre pointe vers la chaîne « Policy ».

Lorsque le système envoie ce message à la suite d’une modification des paramètres régionaux, ce paramètre pointe vers la chaîne « intl ».

Pour modifier les variables d’environnement pour le système ou l’utilisateur, diffusez ce message avec lParam défini sur la chaîne « Environment ».

Valeur retournée

Type : LRESULT

Si vous traitez ce message, retournez zéro.

Remarques

Le paramètre lParam indique la métrique système qui a changé, par exemple, « ConvertibleSlateMode » si l’indicateur CONVERTIBLESLATEMODE a été activé ou « SystemDockMode » si l’indicateur DOCKED a été activé.

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]
En-tête
Winuser.h (include Windows.h)

Voir aussi

Événements de stratégie

SendMessageTimeout

SystemParametersInfo