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 起可用

另請參閱