Função SetUserGeoID (winnls.h)

Artigo
08/27/2023

[SetUserGeoID está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar 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 retornado

Retornará TRUE se tiver êxito 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 que um aplicativo chame 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.

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 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 o aplicativo Configurações do Windows. Outros aplicativos não devem chamar essa função.

Requisitos


Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winnls.h (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll