Função SetUserGeoID (winnls.h)
[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 |