ICorDebugProcess5::EnumerateHeapRegions 方法
取得 Managed 堆積記憶體範圍的列舉值。
語法
HRESULT EnumerateHeapRegions(
[out] ICorDebugHeapSegmentEnum **ppRegions
);
參數
ppRegions[out]ICorDebugHeapSegmentEnum 介面對象的位址指標，該對像是對象位於 Managed 堆積中記憶體範圍的列舉值。
備註
呼叫 ICorDebugProcess5::EnumerateHeapRegions 方法之前，您應該呼叫 ICorDebugProcess5：：GetGCHeapInformation 方法，並檢查傳回之 COR_HEAPINFO 物件的域值areGCStructuresValid，以確保垃圾收集堆積在其目前狀態為可列舉。 此外， ICorDebugProcess5::EnumerateHeapRegions 如果在建立記憶體區域之前，在進程的存留期內太早附加，方法會傳回 E_FAIL 。
此方法保證會列舉可能包含 Managed 物件的所有記憶體區域，但不保證 Managed 對象實際位於這些區域中。 ICorDebugHeapSegmentEnum 集合物件可能包含空白或保留的記憶體區域。
ICorDebugHeapSegmentEnum 介面對像是衍生自 ICorDebugEnum 介面的標準列舉值，可讓您列舉COR_SEGMENT物件。 每個 COR_SEGMENT 物件都會提供特定區段記憶體範圍的相關信息，以及該區段中對象的產生。
需求
平台：請參閱系統需求。
標頭：CorDebug.idl、CorDebug.h
程式庫：CorGuids.lib
.NET Framework 版本： 自 4.5 起提供
