ICorDebugProcess5::EnumerateHeap メソッド

マネージド ヒープ上のオブジェクトの列挙子を取得します。

構文

HRESULT EnumerateHeap(
    [out] ICorDebugHeapEnum **ppObjects
);

パラメーター

ppObject [out]マネージド ヒープ上に存在するオブジェクトの列挙子である ICorDebugHeapEnum インターフェイス オブジェクトのアドレスへのポインター。

注釈

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

ICorDebugHeapEnum インターフェイス オブジェクトは、ICorDebugEnum インターフェイスから派生した標準列挙子であり、COR_HEAPOBJECTオブジェクトを列挙できます。 このメソッドは、すべてのオブジェクトに関する情報を提供する COR_HEAPOBJECT インスタンスを ICorDebugHeapEnum コレクション オブジェクトに設定します。 コレクションには 、 どのオブジェクトにも根ざしていないがガベージ コレクターによってまだ収集されていないオブジェクトに関する情報を提供するCOR_HEAPOBJECT インスタンスも含まれる場合があります。

Requirements

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

ヘッダ： CorDebug.idl、CorDebug.h

図書館： CorGuids.lib

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

こちらも参照ください

• ICorDebugProcess5 インターフェイス