ICLRSyncManager::CreateRWLockOwnerIterator メソッド

  • [アーティクル]

ホストが使用する、リーダー/ライター ロックで待機している一連のタスクを判断する反復子を作成することを共通言語ランタイム (CLR) に要求します。

構文

HRESULT CreateRWLockOwnerIterator (  
    [in]  SIZE_T    cookie,  
    [out] SIZE_T   *pIterator  
);

パラメーター

cookie
[入力] 目的のリーダー/ライター ロックに関連付けられている Cookie。

pIterator
[出力] GetRWLockOwnerNext と DeleteRWLockOwnerIterator のメソッドに渡せる、反復子へのポインター。

戻り値

HRESULT 説明
S_OK CreateRWLockOwnerIterator が正常に返されました。
HOST_E_CLRNOTAVAILABLE CLR がプロセスに読み込まれていないか、CLR がマネージド コードを実行できないまたは呼び出しを正常に処理できない状態です。
HOST_E_TIMEOUT 呼び出しがタイムアウトになりました。
HOST_E_NOT_OWNER 呼び出し元がロックを所有していません。
HOST_E_ABANDONED ブロックされたスレッドまたはファイバーが待機しているときに、イベントが取り消されました。
E_FAIL 原因不明の致命的なエラーが発生しました。 メソッドにより E_FAIL が返されると、そのプロセス内で CLR が使用できなくなります。 後続のホスティング メソッドの呼び出しでは HOST_E_CLRNOTAVAILABLE が返されます。
HOST_E_INVALIDOPERATION 現在マネージド コードを実行しているスレッドで、CreateRWLockOwnerIterator が呼び出されました。

解説

デッドロックの検出時、通常ホストは、CreateRWLockOwnerIterator、DeleteRWLockOwnerIterator、および GetRWLockOwnerNext の各メソッドを呼び出します。 CLR は、リーダー/ライター ロックの維持は試行せず、ホストが、リーダー/ライター ロックが引き続き有効であることを確認する役割を担います。 ホストがロックの有効性を確認するいくつかの戦略は、次のとおりです。

  • ホストが、ブロックでデッドロックが発生しないようにしながら、リーダー/ライター ロックに対する解放呼び出し (例: IHostSemaphore::ReleaseSemaphore) をブロックします。

  • ホストが、ここでもブロックでデッドロックが発生しないようにしながら、リーダー/ライター ロックに関連付けられているイベント オブジェクトに対する待機の終了をブロックします。

Note

CreateRWLockOwnerIterator は、現在アンマネージド コードを実行しているスレッドでのみ呼び出される必要があります。

必要条件

:「システム要件」を参照してください。

ヘッダー: MSCorEE.h

ライブラリ: MSCorEE.dll にリソースとして含まれます

.NET Framework のバージョン: 2.0 以降で使用可能

関連項目