Compartir a través de

Función GetUserDefaultGeoName (winnls.h)

  • Artículo

Recupera la ubicación geográfica predeterminada del usuario como código de dos letras de la Organización Internacional de Normalización (ISO) 3166-1, si está disponible. De lo contrario, un código numérico de la serie M de las Naciones Unidas (ONU), número 49 (M.49).

Sintaxis

int GetUserDefaultGeoName(
  [out] LPWSTR geoName,
  [in]  int    geoNameCount
);

Parámetros

[out] geoName

Puntero a un búfer en el que esta función debe escribir el código numérico de la Organización Internacional de Normalización (ISO) 3166-1 de dos letras o un código numérico de la serie M de las Naciones Unidas (UN), número 49 (M.49).

[in] geoNameCount

Tamaño del búfer que especifica el parámetro geoName. Si este valor es cero, la función solo devuelve el número de caracteres que la función copiaría en el búfer de salida, pero no escribe el nombre de la ubicación geográfica predeterminada del usuario en el búfer.

Valor devuelto

Número de caracteres que la función copiaría en el búfer de salida si el valor del parámetro geoNameCount es cero. De lo contrario, el número de caracteres que copió la función en el búfer que especifica el parámetro geoName.

Cero indica que se produjo un error en la función. 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_INVALID_PARAMETER Un valor de parámetro no era válido.
ERROR_BADDB La función no pudo leer información del Registro.
ERROR_INSUFFICIENT_BUFFER El búfer que especifica el parámetro geoName es demasiado pequeño para la cadena.

Observaciones

Si el código ISO 3166-1 de la ubicación geográfica predeterminada del usuario es "XX" (lo que indica que no se ha asignado ningún código), pero la ubicación tiene asignado un código UN M.49, el código M.49 se devuelve como una cadena decimal.

Si el código ISO 3166-1 de la ubicación geográfica predeterminada del usuario es "XX" (lo que indica que no se ha asignado ningún código), pero la ubicación tiene asignado un código UN M.49, el código M.49 se devuelve como una cadena decimal.

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 de la ONU, consulte códigos de país o área estándar para uso estadístico (M49).

Requisitos

Requisito Valor
cliente mínimo admitido Windows 10, versión 1709 [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2016 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de winnls.h (incluya Windows.h)
biblioteca de Kernel32.lib
DLL de Kernel32.dll

Consulte también