Função SetUserGeoName (winnls.h)

Define a localização geográfica do usuário atual como o código 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 numérico UN M.49 de duas letras para o local geográfico a ser definido para o usuário atual. Para obter os códigos disponíveis no sistema operacional, chame EnumSystemGeoNames.

Valor de retorno

Retorna TRUE se bem-sucedido 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	Description
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.

Observações

Essa função grava no registro a localização geográfica de um determinado usuário em vez de um aplicativo específico. Essa ação afeta o comportamento de outros aplicativos executados pelo usuário. 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 un m.49 numéricos, consulte códigos de país ou área Standard para uso estatístico (M49).

SetUserGeoName destina-se ao uso por aplicativos projetados para alterar as configurações do usuário, como nas Configurações do Windows. Outros aplicativos não devem chamar essa função.

Requirements

Requirement	Value
Cliente mínimo suportado	Windows 10, versão 1709 [somente aplicativos da área de trabalho]
Servidor mínimo compatível	Windows Server 2016 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
Header	winnls.h (inclua Windows.h)
Library	Kernel32.lib
de DLL	Kernel32.dll