ICorDebugProcess5::EnumerateHeapRegions メソッド

マネージド ヒープのメモリ範囲の列挙子を取得します。

構文

HRESULT EnumerateHeapRegions(
   [out] ICorDebugHeapSegmentEnum **ppRegions
);

パラメーター

ppRegions [out]マネージド ヒープ内にオブジェクトが存在するメモリの範囲の列挙子である ICorDebugHeapSegmentEnum インターフェイス オブジェクトのアドレスへのポインター。

注釈

ICorDebugProcess5::EnumerateHeapRegions メソッドを呼び出す前に、ICorDebugProcess5::GetGCHeapInformation メソッドを呼び出し、返されたCOR_HEAPINFO オブジェクトのareGCStructuresValid フィールドの値を調べて、現在の状態のガベージ コレクション ヒープが列挙可能であることを確認する必要があります。 さらに、メモリ領域が作成される前に、プロセスの有効期間の早すぎる場合、 ICorDebugProcess5::EnumerateHeapRegions メソッドは E_FAIL を返します。

このメソッドは、マネージド オブジェクトを含む可能性があるすべてのメモリ領域を列挙することが保証されますが、マネージド オブジェクトがそれらのリージョンに実際に存在することを保証するものではありません。 ICorDebugHeapSegmentEnum コレクション オブジェクトには、空または予約済みのメモリ領域を含めることができます。

ICorDebugHeapSegmentEnum インターフェイス オブジェクトは、ICorDebugEnum インターフェイスから派生した標準列挙子であり、COR_SEGMENTオブジェクトを列挙できます。 各 COR_SEGMENT オブジェクトは、特定のセグメントのメモリ範囲に関する情報と、そのセグメント内のオブジェクトの生成を提供します。

Requirements

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

ヘッダ： CorDebug.idl、CorDebug.h

ライブラリ: CorGuids.lib

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

こちらも参照ください

• ICorDebugProcess5 インターフェイス