Função GetGeoInfoEx (winnls.h)
Recupera informações sobre uma localização geográfica especificada usando um código ISO (Organização Internacional para Padronização) 3166-1 de duas letras ou código da Série M das Nações Unidas (ONU), número 49 (M.49).
Sintaxe
int GetGeoInfoEx(
[in] PWSTR location,
[in] GEOTYPE geoType,
[out, optional] PWSTR geoData,
[in] int geoDataCount
);
Parâmetros
[in] location
O código ISO 3166-1 ou numeric UN M.49 de duas letras para a localização geográfica para a qual obter informações. Para obter os códigos disponíveis no sistema operacional, chame EnumSystemGeoNames.
[in] geoType
O tipo de informação que você deseja recuperar. Os valores possíveis são definidos pela enumeração SYSGEOTYPE . Os seguintes valores da enumeração SYSGEOTYPE não devem ser usados com GetGeoInfoEx:
-
GEO_ID
Esse valor é fornecido para a compatibilidade com versões anteriores. Não use esse valor em novos aplicativos, mas use GEO_NAME .
-
GEO_LCID
Não há suporte para esse valor para a função GetGeoInfoEx .
-
GEO_NATION
Não há suporte para esse valor para a função GetGeoInfoEx .
-
GEO_RFC1766
Não há suporte para esse valor para a função GetGeoInfoEx .
[out, optional] geoData
Um ponteiro para o buffer no qual GetGeoInfoEx deve gravar as informações solicitadas.
[in] geoDataCount
O tamanho do buffer para o qual o parâmetro GeoData aponta, em caracteres. Defina esse parâmetro como 0 para especificar que a função só deve retornar o tamanho do buffer necessário para armazenar as informações solicitadas sem gravar as informações solicitadas no buffer.
Retornar valor
O número de bytes de informações de localização geográfica que a função gravou o buffer de saída. Se geoDataCount for 0, a função retornará o tamanho do buffer necessário para manter as informações sem gravar as informações no buffer.
0 indica que a função não teve êxito. Para obter informações de erro estendidas, chame GetLastError, que pode retornar um dos seguintes códigos de erro:
| Código de retorno | Descrição |
|---|---|
|
O tamanho do buffer fornecido não era grande o suficiente ou estava definido incorretamente como NULL. |
|
Um valor de parâmetro não era válido. |
|
Os valores fornecidos para sinalizadores não eram válidos. |
Comentários
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).
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 10, versão 1709 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2016 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winnls.h |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |