Função SetUserGeoName (winnls.h)
Define a localização geográfica do usuário atual como o código de duas letras da Organização Internacional para a Padronização (ISO) 3166-1 especificado ou o código da Série M das Nações Unidas (ONU), número 49 (M.49).
Sintaxe
BOOL SetUserGeoName(
[in] PWSTR geoName
);
Parâmetros
[in] geoName
O código ISO 3166-1 ou numeric UN M.49 de duas letras para a localização geográfica a ser definida para o usuário atual. Para obter os códigos disponíveis no sistema operacional, chame EnumSystemGeoNames.
Retornar valor
Retornará TRUE se tiver êxito ou FALSE caso contrário.
Se essa função não for bem-sucedida, chame GetLastError, que pode retornar um dos seguintes códigos de erro:
| Código de retorno | Descrição |
|---|---|
|
A política de grupo do computador ou do usuário proibiu essa operação. |
|
Ocorreu um erro inesperado na função . |
|
Um valor de parâmetro era inválido. |
Comentários
Essa função grava no registro a localização geográfica de um usuário específico em vez de um aplicativo específico. Essa ação afeta o comportamento de outros aplicativos que o usuário executa. Como regra, chame essa função somente quando o usuário tiver solicitado explicitamente alterações, mas não por motivos puramente específicos do aplicativo.
Para obter informações sobre códigos ISO 3166-1 de duas letras, consulte Códigos de país – ISO 3166. Para obter informações sobre códigos numéricos do UN M.49, consulte Códigos de país ou área padrão para uso estatístico (M49).
SetUserGeoName destina-se ao uso por aplicativos projetados para alterar as configurações do usuário, como o aplicativo Configurações do Windows. Outros aplicativos não devem chamar essa função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 10, versão 1709 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2016 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winnls.h (inclua Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |