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 areGCStructuresValidCOR_HEAPINFO restituito per assicurarsi che l'heap di Garbage Collection nello stato corrente sia enumerabile. Inoltre, restituisce ICorDebugProcess5::EnumerateHeapE_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 Sistemi operativi supportati da .NET.

Intestazione: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versioni di .NET: Disponibile a partire da .NET Framework 4.5

Vedere anche

• Interfaccia ICorDebugProcess5