IHostTaskManager::SetUILocale 方法
通知主機,通用語言執行平台 (CLR) 已在目前執行中的工作上變更使用者介面 (UI) 地區設定或文化特性 (Culture)。
語法
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 | 封鎖的執行緒或 Fiber 在其上等候時,事件遭到取消。 |
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 起提供