Compartilhar via


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
ERROR_ACCESS_DISABLED_BY_POLICY
A política de grupo do computador ou do usuário proibiu essa operação.
ERROR_INTERNAL_ERROR
Ocorreu um erro inesperado na função .
ERROR_INVALID_PARAMETER
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

Confira também

EnumSystemGeoNames

GetUserDefaultGeoName

Suporte a idiomas nacionais

Funções de suporte à linguagem nacional

SetUserGeoID