ICLRSyncManager::GetMonitorOwner メソッド
指定した Cookie によって識別されるモニターを所有する IHostTask インスタンスを取得します。
HRESULT GetMonitorOwner (
[in] SIZE_T cookie,
[out] IHostTask *ppOwnerHostTask
);
パラメーター
cookie
[入力] モニターに関連付けられた Cookie。ppOwnerHostTask
[出力] 現在モニターを所有している IHostTask へのポインター。タスクが所有権を持たない場合は null。
戻り値
HRESULT |
説明 |
---|---|
S_OK |
GetMonitorOwner が正常に終了しました。 |
HOST_E_CLRNOTAVAILABLE |
CLR がプロセスに読み込まれていません。または、CLR がマネージ コードを実行できない状態か、呼び出しを正常に処理できない状態にあります。 |
HOST_E_TIMEOUT |
呼び出しがタイムアウトしました。 |
HOST_E_NOT_OWNER |
呼び出し元がロックを所有していません。 |
HOST_E_ABANDONED |
ブロックされたスレッドまたはファイバーが待機しているイベントがキャンセルされました。 |
E_FAIL |
未知の重大エラーが発生しました。 メソッドから E_FAIL が返される場合、プロセス内で CLR を使用することはできません。 ホスト メソッドへの後続の呼び出しで、HOST_E_CLRNOTAVAILABLE が返されます。 |
解説
ホストは、通常、GetMonitorOwner を、デッドロック検出機構の中で呼び出します。 Cookie は、IHostSyncManager::CreateMonitorEvent 呼び出しを使用して作成されるときにモニターに関連付けられます。
メモ |
---|
モニターの基になるイベントを解放するための呼び出しは、このメソッドの呼び出しがそのモニターに関連付けられている Cookie で現在有効である場合に、ブロックする可能性があります (ただしデッドロックは発生しません)。他のタスクも、このモニターの取得を試みた場合はブロックします。 |
GetMonitorOwner は、常にすぐに返されます。また、CreateMonitorEvent 呼び出しの後であればいつでも呼び出すことができます。 ホストは、タスクがそのイベントを待機していない限り、待機する必要はありません。
必要条件
プラットフォーム: 「.NET Framework システム要件」を参照
ヘッダー : MSCorEE.h
ライブラリ: MSCorEE.dll にリソースとして格納されていること
.NET Framework のバージョン: 4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0