Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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
- GetUserGeoID
- de compatibilidad con idiomas nacionales
- funciones de compatibilidad con idiomas nacionales
- SetUserGeoName