Metodo ICorDebugProcess5::EnumerateHeap

Articolo
05/11/2024

Ottiene un enumeratore per gli oggetti nell'heap gestito.

Sintassi

C++

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

Condividi tramite