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 požadavky na systém.
Hlavička: CorDebug.idl, CorDebug.h
Knihovna: CorGuids.lib
Verze rozhraní .NET Framework: Dostupné od verze 4.5