IHostTaskManager::BeginThreadAffinity メソッド

2008-08-16

更新 : 2007 年 11 月

マネージコードが現在のタスクを別のオペレーティングシステムスレッドに移動できない期間に入ることをホストに通知します。

HRESULT BeginThreadAffinity ();

戻り値

HRESULT	説明
S_OK	BeginThreadAffinity が正常に終了しました。
HOST_E_CLRNOTAVAILABLE	共通言語ランタイム (CLR: Common Language Runtime) がプロセスに読み込まれていません。または CLR がマネージコードを実行できない状態か、呼び出しを正常に処理できない状態にあります。
HOST_E_TIMEOUT	呼び出しがタイムアウトしました。
HOST_E_NOT_OWNER	呼び出し元がロックを所有していません。
HOST_E_ABANDONED	ブロックされたスレッドまたはファイバが待機しているイベントがキャンセルされました。
E_FAIL	未知の重大エラーが発生しました。メソッドから E_FAIL が返される場合、プロセス内で CLR を使用することはできません。ホストメソッドへの後続の呼び出しで、HOST_E_CLRNOTAVAILABLE が返されます。

解説

一般に CLR は、Thread.BeginThreadAffinity 呼び出しのコンテキスト内で IHostTaskManager::BeginThreadAffinity を呼び出します。対応する呼び出しが IHostTaskManager::EndThreadAffinity に対して行われるまでは、現在のタスクを再スケジュールできません。タスクはスイッチアウトできますが、スイッチして戻す場合は、スイッチアウトしたときと同じオペレーティングシステムスレッドに割り当てる必要があります。呼び出しは現在のタスクを参照するため、入れ子にされている BeginThreadAffinity 呼び出しは影響しません。