Partilhar via


WM_SETTINGCHANGE mensagem

Uma mensagem que é enviada para todas as janelas de nível superior quando a função SystemParametersInfo altera uma configuração em todo o sistema ou quando as configurações de política são alteradas.

Os aplicativos devem enviar WM_SETTINGCHANGE para todas as janelas de nível superior quando fizerem alterações nos parâmetros do sistema. (Esta mensagem não pode ser enviada diretamente para uma janela.) Para enviar a mensagem WM_SETTINGCHANGE para todas as janelas de nível superior, use a função SendMessageTimeout com o parâmetro hwnd definido como HWND_BROADCAST.

Uma janela recebe essa mensagem por meio da função WindowProc.

#define WM_WININICHANGE                 0x001A
#define WM_SETTINGCHANGE                WM_WININICHANGE

Parâmetros

wParam

Quando o sistema envia essa mensagem como resultado de uma chamada SystemParametersInfo , o parâmetro wParam é o valor do parâmetro uiAction passado para a função SystemParametersInfo . Para obter uma lista de valores, consulte SystemParametersInfo.

Quando o sistema envia essa mensagem como resultado de uma alteração nas configurações de política, esse parâmetro indica o tipo de política que foi aplicada. Esse valor será 1 se a política do computador tiver sido aplicada ou zero se a política de usuário tiver sido aplicada.

Quando o sistema envia essa mensagem como resultado de uma alteração nas configurações de localidade, esse parâmetro é zero.

Quando um aplicativo envia essa mensagem, esse parâmetro deve ser NULL.

lParam

Quando o sistema envia essa mensagem como resultado de uma chamada SystemParametersInfo , lParam é um ponteiro para uma cadeia de caracteres que indica a área que contém o parâmetro do sistema que foi alterado. Esse parâmetro geralmente não indica qual parâmetro específico do sistema foi alterado. (Observe que alguns aplicativos enviam essa mensagem com lParam definido como NULL.) Em geral, ao receber essa mensagem, você deve marcar e recarregar as configurações de parâmetro do sistema usadas pelo aplicativo.

Essa cadeia de caracteres pode ser o nome de uma chave do Registro ou o nome de uma seção no arquivo Win.ini. Quando a cadeia de caracteres é um nome de registro, normalmente indica apenas o nó folha no registro, não o caminho completo.

Quando o sistema envia essa mensagem como resultado de uma alteração nas configurações de política, esse parâmetro aponta para a cadeia de caracteres "Policy".

Quando o sistema envia essa mensagem como resultado de uma alteração nas configurações de localidade, esse parâmetro aponta para a cadeia de caracteres "intl".

Para efetuar uma alteração nas variáveis de ambiente do sistema ou do usuário, transmita essa mensagem com lParam definido como a cadeia de caracteres "Ambiente".

Retornar valor

Tipo: LRESULT

Se você processar essa mensagem, retorne zero.

Comentários

O parâmetro lParam indica qual métrica do sistema foi alterada, por exemplo, "ConvertibleSlateMode" se o indicador CONVERSÍVELATEMODE foi alternado ou "SystemDockMode" se o indicador DOCKED foi alternado.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Winuser.h (inclui Windows.h)

Confira também

Eventos de política

Sendmessagetimeout

Systemparametersinfo