Función SetUserGeoName (winnls.h)

  • Artículo

Establece la ubicación geográfica del usuario actual en el código numérico de la Serie M, número 49 (M.49) de la Organización Internacional de Normalización (ISO) 3166-1 especificado.

Sintaxis

BOOL SetUserGeoName(
  [in] PWSTR geoName
);

Parámetros

[in] geoName

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

Valor devuelto

Devuelve TRUE si es correcto o FALSE de lo contrario.

Si esta función no se realiza correctamente, llame a GetLastError, que puede devolver uno de los siguientes códigos de error:

Código devuelto Descripción
ERROR_ACCESS_DISABLED_BY_POLICY
 La directiva de grupo del equipo o el usuario ha prohibido esta operación.
ERROR_INTERNAL_ERROR
 Error inesperado en la función.
ERROR_INVALID_PARAMETER
 Un valor de parámetro no era válido.

Comentarios

Esta función escribe en el registro la ubicación geográfica de un usuario determinado en lugar de una aplicación determinada. Esta acción afecta al comportamiento de otras aplicaciones que ejecuta el usuario. Como regla, llame a esta función solo cuando el usuario haya solicitado explícitamente cambios, pero no por motivos puramente específicos de la aplicación.

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 DE LA M.49, consulte Códigos de país o área estándar para uso estadístico (M49).

SetUserGeoName está diseñado para su uso por las aplicaciones diseñadas para cambiar la configuración del usuario, como la aplicación Configuración de Windows. Otras aplicaciones no deben llamar a esta función.

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 (incluya Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

EnumSystemGeoNames

GetUserDefaultGeoName

Compatibilidad con idiomas nacionales

Funciones de compatibilidad con idiomas nacionales

SetUserGeoID