ICorDebugProcess5::EnumerateHeap – metoda

Získá enumerátor pro objekty ve spravované haldě.

Syntaxe

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

Parametry

ppObject [ven] Ukazatel na adresu objektu rozhraní ICorDebugHeapEnum , který je enumerátorem pro objekty, které se nacházejí ve spravované haldě.

Poznámky

Před voláním ICorDebugProcess5::EnumerateHeap metody byste měli volat ICorDebugProcess5::GetGCHeapInformation metoda a prozkoumat hodnotu areGCStructuresValid pole vráceného COR_HEAPINFO objektu, aby se zajistilo, že haldu uvolňování paměti v jeho aktuálním stavu je výčet. Kromě toho se vrátíE_FAIL, ICorDebugProcess5::EnumerateHeap pokud připojíte příliš brzy v době životnosti procesu před přidělením paměti pro spravovanou haldu.

ICorDebugHeapEnum interface object je standardní enumerátor odvozený z ICorDebugEnum rozhraní, které umožňuje vytvořit výčet COR_HEAPOBJECT objekty. Tato metoda naplní ICorDebugHeapEnum objekt kolekce COR_HEAPOBJECT instance, které poskytují informace o všech objektech. Kolekce může také zahrnovat COR_HEAPOBJECT instance, které poskytují informace o objektech, které nejsou rootovány žádným objektem, ale dosud nebyly shromážděny uvolňováním paměti.

Požadavky

Platformy: Viz podporované operační systémy .NET.

Záhlaví: CorDebug.idl, CorDebug.h

Knihovna: CorGuids.lib

Verze .NET: K dispozici od rozhraní .NET Framework 4.5

Viz také

• ICorDebugProcess5 – rozhraní