messaggio WM_SETTINGCHANGE

Messaggio inviato a tutte le finestre di primo livello quando la funzione SystemParametersInfo modifica un'impostazione a livello di sistema o quando le impostazioni dei criteri sono state modificate.

Le applicazioni devono inviare WM_SETTINGCHANGE a tutte le finestre di primo livello quando apportano modifiche ai parametri di sistema. Questo messaggio non può essere inviato direttamente a una finestra. Per inviare il messaggio di WM_SETTINGCHANGE a tutte le finestre di primo livello, usare la funzione SendMessageTimeout con il parametro hwnd impostato su HWND_BROADCAST.

Una finestra riceve questo messaggio tramite la relativa funzione WindowProc .

#define WM_WININICHANGE                 0x001A
#define WM_SETTINGCHANGE                WM_WININICHANGE

Parametri

wParam

Quando il sistema invia questo messaggio come risultato di una chiamata SystemParametersInfo , il parametro wParam è il valore del parametro uiAction passato alla funzione SystemParametersInfo . Per un elenco di valori, vedere SystemParametersInfo.

Quando il sistema invia questo messaggio in seguito a una modifica delle impostazioni dei criteri, questo parametro indica il tipo di criterio applicato. Questo valore è 1 se i criteri computer sono stati applicati o zero se sono stati applicati criteri utente.

Quando il sistema invia questo messaggio in seguito a una modifica delle impostazioni locali, questo parametro è zero.

Quando un'applicazione invia questo messaggio, questo parametro deve essere NULL.

lParam

Quando il sistema invia questo messaggio come risultato di una chiamata SystemParametersInfo , lParam è un puntatore a una stringa che indica l'area contenente il parametro di sistema modificato. Questo parametro non indica in genere quale parametro di sistema specifico è stato modificato. Si noti che alcune applicazioni inviano questo messaggio con lParam impostato su NULL. In generale, quando si riceve questo messaggio, è necessario controllare e ricaricare le impostazioni dei parametri di sistema usate dall'applicazione.

Questa stringa può essere il nome di una chiave del Registro di sistema o il nome di una sezione nel file di Win.ini. Quando la stringa è un nome del Registro di sistema, in genere indica solo il nodo foglia nel Registro di sistema, non il percorso completo.

Quando il sistema invia questo messaggio in seguito a una modifica delle impostazioni dei criteri, questo parametro punta alla stringa "Policy".

Quando il sistema invia questo messaggio in seguito a una modifica delle impostazioni locali, questo parametro punta alla stringa "intl".

Per modificare le variabili di ambiente per il sistema o l'utente, trasmettere questo messaggio con lParam impostato sulla stringa "Ambiente".

Valore restituito

Tipo: LRESULT

Se si elabora questo messaggio, restituire zero.

Commenti

Il parametro lParam indica quale metrica di sistema è stata modificata, ad esempio "ConvertibleSlateMode" se l'indicatore CONVERTIBLESLATEMODE è stato attivato o "SystemDockMode" se l'indicatore DOCKED è stato attivato o disattivato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Winuser.h (include Windows.h)

Vedi anche

Eventi dei criteri

SendMessageTimeout

Systemparametersinfo