Compartir a través de


Función GetUserDefaultGeoName (winnls.h)

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).

Syntax

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

Parameters

[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

The size of the buffer that the geoName parameter specifies. 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.

Return value

The number of characters the function would copy to the output buffer if the value of the geoNameCount parameter is zero. Otherwise, the number of characters that the function copied to the buffer that the geoName parameter specifies.

Cero indica que se produjo un error en la función. To get extended error information, call GetLastError, which can return one of the following error codes:

Return code Description
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 The buffer that the geoName parameter specifies is too small for the string.

Remarks

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).

Requirements

Requirement Value
cliente mínimo admitido Windows 10, versión 1709 [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2016 [solo aplicaciones de escritorio]
Target Platform Windows
Header winnls.h (incluya Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

See also