IHostTaskManager::SetUILocale 方法

  • 项目

通知主机公共语言运行时 (CLR) 已更改当前执行任务的用户界面 (UI) 区域设置或区域性。

语法

HRESULT SetUILocale (  
    [in] LCID lcid  
);

参数

lcid
[in] 映射到新分配的地理区域性和语言的区域设置标识符值。

返回值

HRESULT 说明
S_OK 已成功返回 SetUILocale。
HOST_E_CLRNOTAVAILABLE CLR 未加载到进程中，或 CLR 处于无法运行托管代码或无法成功处理调用的状态。
HOST_E_TIMEOUT 调用超时。
HOST_E_NOT_OWNER 调用方未持有锁。
HOST_E_ABANDONED 阻塞的线程或纤程正在等待某一事件，而该事件已被取消。
E_FAIL 发生未知的灾难性故障。 当方法返回 E_FAIL 时，进程中无法再使用 CLR。 后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。
E_NOTIMPL 主机不允许托管用户代码更改 UI 区域性。

注解

当托管代码更改 Thread.CurrentUICulture 属性的值时，运行时将调用 SetUILocale。 此方法为主机提供了执行对于区域设置同步可能具有的任何机制的机会。 如果主机不允许从托管代码更改 UI 区域设置，或者没有实现同步区域设置的机制，则它应该从此方法返回 E_NOTIMPL。

要求

平台：请参阅系统要求。

标头：MSCorEE.h

库：作为资源包含在 MSCorEE.dll 中

.NET Framework 版本：自 2.0 起可用

另请参阅