ICorDebugProcess5::EnumerateHeap 方法
取得 Managed 堆積上物件的列舉值。
語法
HRESULT EnumerateHeap(
[out] ICorDebugHeapEnum **ppObjects
);
參數
ppObject
[out]ICorDebugHeapEnum 介面對象的位址指標,該對像是位於 Managed 堆積上之物件的列舉值。
備註
呼叫 ICorDebugProcess5::EnumerateHeap
方法之前,您應該呼叫 ICorDebugProcess5::GetGCHeapInformation 方法,並檢查傳回之 COR_HEAPINFO 物件的域值areGCStructuresValid
,以確保垃圾收集堆積在其目前狀態為可列舉。 此外, ICorDebugProcess5::EnumerateHeap
如果您在進程的存留期內太早附加,則會傳回 E_FAIL
,然後再配置 Managed 堆積的記憶體。
ICorDebugHeapEnum 介面物件是衍生自 ICorDebugEnum 介面的標準列舉值,可讓您列舉COR_HEAPOBJECT物件。 這個方法會在 ICorDebugHeapEnum 集合物件中填入 COR_HEAPOBJECT 實例,以提供所有對象的相關信息。 集合也可以包含 COR_HEAPOBJECT 實例,這些實例會提供任何物件尚未收集但尚未由垃圾收集行程所收集之對象的相關信息。
需求
平台:請參閱系統需求。
標頭:CorDebug.idl、CorDebug.h
程式庫:CorGuids.lib
.NET Framework 版本: 自 4.5 起提供