Función GetGeoInfoEx (winnls.h)

  • Artículo

Recupera información sobre una ubicación geográfica que especifique mediante un código de la Organización Internacional de Normalización (ISO) 3166-1 o código numérico de las Naciones Unidas (UN), número 49 (M.49).

Sintaxis

int GetGeoInfoEx(
  [in]            PWSTR   location,
  [in]            GEOTYPE geoType,
  [out, optional] PWSTR   geoData,
  [in]            int     geoDataCount
);

Parámetros

[in] location

Código ISO 3166-1 de dos letras o numérico UN M.49 para la ubicación geográfica para la que se va a obtener información. Para obtener los códigos disponibles en el sistema operativo, llame a EnumSystemGeoNames.

[in] geoType

Tipo de información que desea recuperar. Los valores posibles se definen mediante la enumeración SYSGEOTYPE . Los siguientes valores de la enumeración SYSGEOTYPE no deben usarse con GetGeoInfoEx:

  • GEO_ID

    Este valor se proporciona por motivos de compatibilidad con versiones anteriores. No use este valor en las nuevas aplicaciones, pero use GEO_NAME en su lugar.

  • GEO_LCID

    Este valor no se admite para la función GetGeoInfoEx .

  • GEO_NATION

    Este valor no se admite para la función GetGeoInfoEx .

  • GEO_RFC1766

    Este valor no se admite para la función GetGeoInfoEx .

[out, optional] geoData

Puntero al búfer en el que GetGeoInfoEx debe escribir la información solicitada.

[in] geoDataCount

Tamaño del búfer al que apunta el parámetro GeoData , en caracteres. Establezca este parámetro en 0 para especificar que la función solo debe devolver el tamaño del búfer necesario para almacenar la información solicitada sin escribir la información solicitada en el búfer.

Valor devuelto

Número de bytes de información de ubicación geográfica que la función escribió el búfer de salida. Si geoDataCount es 0, la función devuelve el tamaño del búfer necesario para contener la información sin escribir la información en el búfer.

0 indica que la función no se realizó correctamente. Para obtener información de error extendida, llame a GetLastError, que puede devolver uno de los siguientes códigos de error:

Código devuelto Descripción
ERROR_INSUFFICIENT_BUFFER
 El tamaño del búfer proporcionado no era lo suficientemente grande o se estableció incorrectamente en NULL.
ERROR_INVALID_PARAMETER
 Un valor de parámetro no era válido.
ERROR_INVALID_FLAGS
 Los valores proporcionados para las marcas no eran válidos.

Comentarios

Para obtener información sobre los códigos ISO 3166-1 de dos letras, vea Códigos de país : ISO 3166. Para obtener información sobre los códigos NUMÉRICOS M.49, consulte Códigos de país o área estándar para uso estadístico (M49).

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1709 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2016 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winnls.h
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

EnumSystemGeoNames

GetGeoInfo

Compatibilidad con idiomas nacionales

Funciones de compatibilidad con idiomas nacionales

SYSGEOTYPE