Metodo ICorDebugProcess5::EnumerateHeap

  • Articolo

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.

Commenti

Prima di chiamare il metodo, è necessario chiamare il ICorDebugProcess5::EnumerateHeap metodo ICorDebugProcess5::GetGCHeapInformation ed esaminare il valore del campo dell'oggetto areGCStructuresValidCOR_HEAPINFO restituito per assicurarsi che l'heap di Garbage Collection nel relativo stato corrente sia enumerabile. Inoltre, il ICorDebugProcess5::EnumerateHeap restituisce E_FAIL se si associa troppo presto alla durata del processo, prima che venga allocata la memoria per l'heap gestito.

L'oggetto interfaccia ICorDebugHeapEnum è un enumeratore standard derivato dall'interfaccia ICorDebugEnum che consente di enumerare gli oggetti COR_HEAPOBJECT . Questo metodo popola l'oggetto raccolta ICorDebugHeapEnum con istanze COR_HEAPOBJECT che forniscono informazioni su tutti gli oggetti. La raccolta può includere anche istanze COR_HEAPOBJECT che forniscono informazioni sugli oggetti che non sono radicati da alcun oggetto, ma non sono ancora stati raccolti dal Garbage Collector.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: CorDebug.idl, CorDebug.h

Libreria: CorGuids.lib

Versioni di .NET Framework: Disponibile dalla versione 4.5

Vedi anche