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

另請參閱