Metodo ICorDebugProcess5::EnumerateHeapRegions
Ottiene un enumeratore per gli intervalli di memoria dell'heap gestito.
Sintassi
HRESULT EnumerateHeapRegions(
[out] ICorDebugHeapSegmentEnum **ppRegions
);
Parametri
ppRegions [out] Puntatore all'indirizzo di un oggetto interfaccia ICorDebugHeapSegmentEnum che è un enumeratore per gli intervalli di memoria in cui si trovano gli oggetti nell'heap gestito.
Osservazioni:
Prima di chiamare il ICorDebugProcess5::EnumerateHeapRegions 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, il ICorDebugProcess5::EnumerateHeapRegions metodo restituisce E_FAIL se si collega troppo presto nella durata del processo, prima che vengano create aree di memoria.
Questo metodo è garantito di enumerare tutte le aree di memoria che possono contenere oggetti gestiti, ma non garantisce che gli oggetti gestiti si trovino effettivamente in tali aree. L'oggetto insieme ICorDebugHeapSegmentEnum può includere aree di memoria vuote o riservate.
L'oggetto interfaccia ICorDebugHeapSegmentEnum è un enumeratore standard derivato dall'interfaccia ICorDebugEnum che consente di enumerare COR_SEGMENT oggetti. Ogni oggetto COR_SEGMENT fornisce informazioni sull'intervallo di memoria di un determinato segmento, insieme alla generazione degli oggetti in tale segmento.
Requisiti
Piattaforme: vedere Requisiti di sistema.
Intestazione: CorDebug.idl, CorDebug.h
Libreria: CorGuids.lib
Versioni di .NET Framework: disponibili dalla versione 4.5
