IHostTaskManager::SetUILocale (Método)

Artículo
08/23/2008

Actualización: noviembre 2007

Notifica al host que Common Language Runtime (CLR) ha cambiado la configuración regional o la referencia cultural de la interfaz de usuario en la tarea que se está ejecutando actualmente.

HRESULT SetUILocale (
    [in] LCID lcid
);

Parámetros

lcid
[in] Valor de identificador de la configuración regional que se asigna a la referencia cultural geográfica y al idioma recién asignados.

Valor devuelto

HRESULT	Descripción
S_OK	SetUILocale se devolvió correctamente.
HOST_E_CLRNOTAVAILABLE	CLR no se ha cargado en un proceso o está en un estado en el que no puede ejecutar el código administrado o procesar la llamada correctamente.
HOST_E_TIMEOUT	Se agotó el tiempo de espera de la llamada.
HOST_E_NOT_OWNER	El llamador no posee el bloqueo.
HOST_E_ABANDONED	Se canceló un evento mientras una fibra o un subproceso bloqueado estaba esperándole.
E_FAIL	Se ha producido un error catastrófico desconocido. Si un método devuelve E_FAIL, CLR no se puede seguir utilizando en el proceso. Las llamadas subsiguientes a métodos de hospedaje devuelven HOST_E_CLRNOTAVAILABLE.
E_NOTIMPL	El host no permite al código de usuario administrado cambiar la referencia cultural de la interfaz de usuario.

Comentarios

El motor en tiempo de ejecución llama a SetUILocale cuando el código administrado cambia el valor de la propiedad Thread.CurrentUICulture. Este método permite al host ejecutar los mecanismos que sean necesarios para la sincronización de las configuraciones regionales. Si un host no permite cambiar la configuración regional de la interfaz de usuario desde el código administrado o no implementa un mecanismo para sincronizar las configuraciones regionales, debe devolver E_NOTIMPL desde este método.