IHostTask::Alert メソッド

[アーティクル]
08/09/2011

現在の IHostTask インスタンスが表すタスクを起動するようにホストに要求します。これにより、タスクを中止できるようになります。

HRESULT Alert ();

戻り値

HRESULT	説明
S_OK	メソッドは正常終了しました。
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.Abort が呼び出されるとき、または現在の Thread に関連付けられている AppDomain がシャットダウンされるときに、Alert メソッドを呼び出します。この呼び出しは非同期で行われるので、ホストはすぐに制御を返す必要があります。ホストがタスクにすぐに警告できなかった場合、ホストは次回タスクが警告を受けることができる状態になったときにそれを起動する必要があります。

メモ
Alert は、ランタイムが Join などのメソッドに WAIT_ALERTABLE の WAIT_OPTION 値を渡しているタスクに対してのみ影響します。