IHostTask::SetPriority メソッド

現在の IHostTask インスタンスが表すタスクのスレッドの優先順位を変更するようにホストに要求します。

HRESULT SetPriority (
    [in] int newPriority
);

パラメーター

HRESULT	説明
S_OK	SetPriority が正常に終了しました。
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 を返します。

スレッドの処理時間は、スレッドの優先順位の一部を使用するラウンドロビンシステムを使用して設定されます。 SetPriority を使用すると、CLR はこのスレッドの優先順位を現在のタスクに設定できます。次の newPriority 値がサポートされています。

Thread.Priority の値がユーザーコードによって変更されると、CLR が SetPriority を呼び出します。ホストはスレッドの優先順位割り当ての独自のアルゴリズムを定義して、この要求を無視できます。

メモ
SetPriority は、スレッドの優先順位が変更されたかどうかについて報告しません。IHostTask::GetPriority を呼び出して、タスクのスレッドの優先順位の値を確認してください。