Función SetUserGeoID (winnls.h)

  • Artículo

[SetUserGeoID está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. En su lugar, use SetUserGeoName.

]

Establece el identificador de ubicación geográfica para el usuario. Este identificador debe tener uno de los valores descritos en Tabla de ubicaciones geográficas.

Sintaxis

BOOL SetUserGeoID(
  [in] GEOID GeoId
);

Parámetros

[in] GeoId

Identificador de la ubicación geográfica del usuario.

Valor devuelto

Devuelve TRUE si es correcto o FALSE de lo contrario.

Windows XP, Windows Server 2003: esta función no proporciona información de error extendida. Por lo tanto, no es adecuado que una aplicación llame a GetLastError después de esta función. Si la aplicación llama a GetLastError, puede devolver un valor establecido por alguna función denominada anteriormente.

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

  • 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. Cualquiera de los valores 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, la aplicación debe llamar a esta función solo cuando el usuario haya solicitado explícitamente cambios, pero no por motivos puramente específicos de la aplicación.

SetUserGeoID 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

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winnls.h (incluya Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

GetUserGeoID

Compatibilidad con idiomas nacionales

Funciones de compatibilidad con idiomas nacionales

SetUserGeoName

Tabla de ubicaciones geográficas