Função SetUserGeoID (winnls.h)

[SetUserGeoID está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes. Em vez disso, use SetUserGeoName.

]

Define o identificador de localização geográfica para o usuário. Esse identificador deve ter um dos valores descritos em Tabela de Localizações Geográficas.

Sintaxe

BOOL SetUserGeoID(
  [in] GEOID GeoId
);

Parâmetros

[in] GeoId

Identificador para a localização geográfica do usuário.

Valor de retorno

Retorna TRUE se bem-sucedido ou FALSE caso contrário.

Windows XP, Windows Server 2003: essa função não fornece informações de erro estendidas. Portanto, não é apropriado para um aplicativo chamar GetLastError após essa função. Se o aplicativo chamar GetLastError, ele poderá retornar um valor definido por alguma função chamada anteriormente.

Se essa função não for bem-sucedida, o aplicativo poderá chamar GetLastError, que pode retornar um dos seguintes códigos de erro:

• 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. Qualquer um dos valores 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, o aplicativo deve chamar essa função somente quando o usuário tiver solicitado explicitamente alterações, mas não por motivos puramente específicos do aplicativo.

SetUserGeoID 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

Consulte também

GetUserGeoID

de Suporte à Linguagem Nacional

funções de suporte à linguagem nacional

SetUserGeoName

Tabela de localizações geográficas