IHostTaskManager::BeginThreadAffinity 方法

發行項
08/12/2011

向主應用程式告知，Managed 程式碼正進入不得將目前工作移至另一個作業系統執行緒的週期。

HRESULT BeginThreadAffinity ();

傳回值

HRESULT	描述
S_OK	BeginThreadAffinity 已成功傳回。
HOST_E_CLRNOTAVAILABLE	Common Language Runtime (CLR) 尚未載入至處理序中，或者此 CLR 目前的狀態無法執行 Managed 程式碼或成功處理呼叫。
HOST_E_TIMEOUT	呼叫已逾時。
HOST_E_NOT_OWNER	呼叫端不具備鎖定功能。
HOST_E_ABANDONED	已封鎖執行緒或 Fiber 在等候事件時，該事件已遭取消。
E_FAIL	發生未知的重大錯誤。當方法傳回 E_FAIL 時，便無法在處理序內使用 CLR。對裝載方法的後續呼叫會傳回 HOST_E_CLRNOTAVAILABLE。

備註

CLR 通常會在 Thread.BeginThreadAffinity 的呼叫內容中呼叫 IHostTaskManager::BeginThreadAffinity。等到針對 IHostTaskManager::EndThreadAffinity 發出對應的呼叫之後，才可以重新排定目前的工作。工作可以切換出去，但是當切換回來之後，必須將工作指派給之前切換出去時的相同作業系統執行緒。 BeginThreadAffinity 的巢狀呼叫沒有任何效果，因為此呼叫會參考目前的工作。