通知主机公共语言运行时(CLR)已更改当前正在执行的任务的区域设置或区域性。
Syntax
HRESULT SetLocale (
[in] LCID lcid
);
参数
lcid [in]映射到新分配的地理文化和语言的区域设置标识符值。
返回值
| HRESULT | 说明 |
|---|---|
| S_OK |
SetLocale 已成功返回。 |
| 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 | 主机不允许托管用户代码修改区域设置。 |
注解
当托管代码更改属性的值Thread.CurrentCulture时,运行时将调用SetLocale。 此方法为主机提供了执行它可能用于同步区域设置的任何机制的机会。 如果主机不允许从托管代码更改区域设置,或者不实现同步区域设置的机制,则应从此方法返回E_NOTIMPL。
要求
平台:请参阅系统要求。
页眉: MSCorEE.h
图书馆: 作为资源包含在 MSCorEE.dll
.NET Framework 版本: 自 2.0 起可用