ICorDebugProcess5::EnumerateHeap 方法
取得受控堆積上物件的列舉程式。
語法
HRESULT EnumerateHeap(
[out] ICorDebugHeapEnum **ppObjects
);
參數
ppObject
[out] ICorDebugHeapEnum 介面物件的位址指標,該物件是位於受控堆積之物件的列舉程式。
備註
呼叫 ICorDebugProcess5::EnumerateHeap
方法之前,您應該呼叫 ICorDebugProcess5::GetGCHeapInformation 方法,並檢查所傳回 COR_HEAPINFO 物件的 areGCStructuresValid
欄位值,以確保目前狀態的記憶體回收堆積為可列舉。 此外,如果您在處理序的存留期內太早連結 (在配置受控堆積的記憶體之前),則 ICorDebugProcess5::EnumerateHeap
會傳回 E_FAIL
。
ICorDebugHeapEnum 介面物件是衍生自 ICorDebugEnum 介面的標準列舉程式,可讓您列舉 COR_HEAPOBJECT 物件。 這個方法會在 ICorDebugHeapEnum 集合物件中填入可提供所有物件相關資訊的 COR_HEAPOBJECT 執行個體。 此集合可能也包含 COR_HEAPOBJECT 執行個體,可提供任何物件尚未根植,但尚未由記憶體回收行程回收的物件相關資訊。
規格需求
平台:請參閱系統需求。
標頭:CorDebug.idl、CorDebug.h
程式庫:CorGuids.lib
.NET Framework版本:自 4.5 起可用