ICorDebugHeapValue2::CreateHandle メソッド

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

構文

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

パラメーター

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

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

注釈

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

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

Requirements

プラットフォーム：サポートされている .NET オペレーティング システムを参照してください。

ヘッダ： CorDebug.idl、CorDebug.h

図書館： CorGuids.lib

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