Função GetGeoInfoEx (winnls.h)

  • Artigo

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
ERROR_INSUFFICIENT_BUFFER
 O tamanho do buffer fornecido não era grande o suficiente ou estava definido incorretamente como NULL.
ERROR_INVALID_PARAMETER
 Um valor de parâmetro não era válido.
ERROR_INVALID_FLAGS
 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

Confira também

EnumSystemGeoNames

GetGeoInfo

Suporte a idiomas nacionais

Funções de suporte à linguagem nacional

SYSGEOTYPE