ICorDebugProcess5::EnumerateHeapRegions – metoda

Získá enumerátor pro rozsahy paměti spravované haldy.

Syntaxe

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

Parametry

ppRegions [ven] Ukazatel na adresu ICorDebugHeapSegmentEnum objekt rozhraní, který je enumerátor pro rozsahy paměti, ve kterých se objekty nacházejí ve spravované haldě.

Poznámky

Před voláním ICorDebugProcess5::EnumerateHeapRegions 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 metoda vrátíE_FAIL, ICorDebugProcess5::EnumerateHeapRegions pokud připojíte příliš brzy v době životnosti procesu před vytvořením oblastí paměti.

Tato metoda zaručuje výčet všech oblastí paměti, které mohou obsahovat spravované objekty, ale nezaručuje, že spravované objekty se ve skutečnosti nacházejí v těchto oblastech. Objekt kolekce ICorDebugHeapSegmentEnum může obsahovat prázdné nebo rezervované oblasti paměti.

ICorDebugHeapSegmentEnum interface object je standardní enumerátor odvozený z ICorDebugEnum rozhraní, které umožňuje vytvořit výčet COR_SEGMENT objekty. Každý COR_SEGMENT objekt poskytuje informace o rozsahu paměti konkrétního segmentu spolu s generováním objektů v daném segmentu.

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í