ICorDebugProcess2::GetReferenceValueFromGCHandle メソッド

ガベージ コレクション ハンドルが含まれる指定済みのマネージド オブジェクトへの参照ポインターを取得します。

構文

HRESULT GetReferenceValueFromGCHandle (
    [in]  UINT_PTR                 handle,
    [out] ICorDebugReferenceValue  **pOutValue
);

パラメーター

handle [in]ガベージ コレクション ハンドルを持つマネージド オブジェクトへのポインター。 この値は IntPtr オブジェクトであり、マネージド オブジェクトについては GCHandle から取得できます。

pOutValue [out]指定したマネージド オブジェクトへの参照を表す ICorDebugReferenceValue オブジェクトのアドレスへのポインター。

解説

返された参照値とガベージ コレクション参照値を混同しないでください。

返された参照は、通常の参照のように動作します。 ブレークポイント後もコードの実行が続行する場合は無効になります。 ターゲット オブジェクトの有効期間は、参照値の有効期間の影響を受けません。

Note

GetReferenceValueFromGCHandle メソッドでは、ハンドルは検証されません。 したがって、無効なハンドルが渡された場合には、GetReferenceValueFromGCHandle メソッドにより、デバッガーとデバッグされているコードの両方が破損される可能性があります。

必要条件

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

ヘッダー: CorDebug.idl、CorDebug.h

ライブラリ: CorGuids.lib

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