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