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:

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

Confira também

EnumSystemGeoNames

GetUserDefaultGeoName

Suporte a idiomas nacionais

Funções de suporte à linguagem nacional

SetUserGeoID