WM_SETTINGCHANGE pesan

Pesan yang dikirim ke semua jendela tingkat atas ketika fungsi SystemParametersInfo mengubah pengaturan di seluruh sistem atau ketika pengaturan kebijakan telah berubah.

Aplikasi harus mengirim WM_SETTINGCHANGE ke semua jendela tingkat atas ketika mereka membuat perubahan pada parameter sistem. (Pesan ini tidak dapat dikirim langsung ke jendela.) Untuk mengirim pesan WM_SETTINGCHANGE ke semua jendela tingkat atas, gunakan fungsi SendMessageTimeout dengan parameter hwnd diatur ke HWND_BROADCAST.

Jendela menerima pesan ini melalui fungsi WindowProc-nya .

#define WM_WININICHANGE                 0x001A
#define WM_SETTINGCHANGE                WM_WININICHANGE

Parameter

wParam

Ketika sistem mengirim pesan ini sebagai akibat dari panggilan SystemParametersInfo , parameter wParam adalah nilai parameter uiAction yang diteruskan ke fungsi SystemParametersInfo . Untuk daftar nilai, lihat SystemParametersInfo.

Ketika sistem mengirim pesan ini sebagai akibat dari perubahan pengaturan kebijakan, parameter ini menunjukkan jenis kebijakan yang diterapkan. Nilai ini adalah 1 jika kebijakan komputer diterapkan atau nol jika kebijakan pengguna diterapkan.

Ketika sistem mengirim pesan ini sebagai akibat dari perubahan pengaturan lokal, parameter ini adalah nol.

Ketika aplikasi mengirim pesan ini, parameter ini harus NULL.

lParam

Ketika sistem mengirim pesan ini sebagai akibat dari panggilan SystemParametersInfo , lParam adalah penunjuk ke string yang menunjukkan area yang berisi parameter sistem yang diubah. Parameter ini biasanya tidak menunjukkan parameter sistem tertentu mana yang berubah. (Perhatikan bahwa beberapa aplikasi mengirim pesan ini dengan lParam diatur ke NULL.) Secara umum, ketika Anda menerima pesan ini, Anda harus memeriksa dan memuat ulang pengaturan parameter sistem apa pun yang digunakan oleh aplikasi Anda.

String ini dapat menjadi nama kunci registri atau nama bagian dalam file Win.ini. Ketika string adalah nama registri, biasanya hanya menunjukkan simpul daun di registri, bukan jalur lengkap.

Ketika sistem mengirim pesan ini sebagai akibat dari perubahan pengaturan kebijakan, parameter ini menunjuk ke string "Kebijakan".

Ketika sistem mengirim pesan ini sebagai akibat dari perubahan pengaturan lokal, parameter ini menunjuk ke string "intl".

Untuk memengaruhi perubahan variabel lingkungan untuk sistem atau pengguna, siarkan pesan ini dengan lParam yang diatur ke string "Lingkungan".

Nilai kembali

Jenis: LRESULT

Jika Anda memproses pesan ini, kembalikan nol.

Keterangan

Parameter lParam menunjukkan metrik sistem mana yang telah berubah, misalnya, "ConvertibleSlateMode" jika indikator CONVERTIBLESLATEMODE dialihkan atau "SystemDockMode" jika indikator DOCKED dialihkan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	Winuser.h (termasuk Windows.h)

Lihat juga

Peristiwa Kebijakan

SendMessageTimeout

SystemParametersInfo