Metodo ICorDebugProcess5::EnumerateHeap
Ottiene un enumeratore per gli oggetti nell'heap gestito.
Sintassi
HRESULT EnumerateHeap(
[out] ICorDebugHeapEnum **ppObjects
);
Parametri
ppObject [out] Puntatore all'indirizzo di un oggetto interfaccia ICorDebugHeapEnum che è un enumeratore per gli oggetti che risiedono nell'heap gestito.
Osservazioni:
Prima di chiamare il ICorDebugProcess5::EnumerateHeap metodo , è necessario chiamare il metodo ICorDebugProcess5::GetGCHeapInformation ed esaminare il valore del campo dell'oggetto areGCStructuresValid restituito COR_HEAPINFO per assicurarsi che l'heap di Garbage Collection nello stato corrente sia enumerabile. Inoltre, restituisce ICorDebugProcess5::EnumerateHeap E_FAIL se si collega troppo presto nella durata del processo, prima dell'allocazione della memoria per l'heap gestito.
L'oggetto interfaccia ICorDebugHeapEnum è un enumeratore standard derivato dall'interfaccia ICorDebugEnum che consente di enumerare COR_HEAPOBJECT oggetti. Questo metodo popola l'oggetto insieme ICorDebugHeapEnum con COR_HEAPOBJECT istanze che forniscono informazioni su tutti gli oggetti. La raccolta può includere anche COR_HEAPOBJECT istanze che forniscono informazioni sugli oggetti che non sono rooted da alcun oggetto ma non sono ancora stati raccolti dal Garbage Collector.
Requisiti
Piattaforme: vedere Requisiti di sistema.
Intestazione: CorDebug.idl, CorDebug.h
Libreria: CorGuids.lib
Versioni di .NET Framework: disponibili dalla versione 4.5
