ICorDebugHeapValue2::CreateHandle メソッド

この ICorDebugHeapValue2 オブジェクトによって表されるヒープ値に対して指定された種類のハンドルを作成します。

構文

HRESULT CreateHandle (
    [in] CorDebugHandleType      type,
    [out] ICorDebugHandleValue   **ppHandle
);

パラメーター

type [in]作成するハンドルの種類を指定する CorDebugHandleType 列挙体の値。

ppHandle [out]このヒープ値の新しいハンドルを表す ICorDebugHandleValue オブジェクトのアドレスへのポインター。

解説

ハンドルは、ヒープ値に関連付けられているアプリケーション ドメインに作成され、アプリケーション ドメインがアンロードされると無効になります。

同じヒープ値に対してこの関数を複数回呼び出すと、複数のハンドルが作成されます。 ハンドルはガベージ コレクターのパフォーマンスに影響を与えるため、デバッガーは、一度にアクティブになるハンドルを比較的少数 (約 256) に制限する必要があります。

必要条件

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

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

ライブラリ: CorGuids.lib

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