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