ICorDebugProcess5::EnumerateHeapRegions (Método)

  • Artículo

Obtiene un enumerador para los rangos de memoria del montón administrado.

Sintaxis

HRESULT EnumerateHeapRegions(  
   [out] ICorDebugHeapSegmentEnum **ppRegions  
);

Parámetros

ppRegions
[out] Puntero a la dirección de un objeto de interfaz ICorDebugHeapSegmentEnum que es un enumerador para los intervalos de memoria en los que residen los objetos en el montón administrado.

Comentarios

Antes de llamar al método ICorDebugProcess5::EnumerateHeapRegions, debe llamar al método ICorDebugProcess5::GetGCHeapInformation y examinar el valor del campo areGCStructuresValid del objeto devuelto COR_HEAPINFO para asegurarse de que el montón de recolección de elementos no utilizados en su estado actual es enumerable. Además, el método ICorDebugProcess5::EnumerateHeapRegions devuelve E_FAIL si se asocia demasiado pronto en la duración del proceso, antes de crear regiones de memoria.

Se garantiza que este método enumera todas las regiones de memoria que pueden contener objetos administrados, pero no garantiza que los objetos administrados residan realmente en esas regiones. El objeto de colección ICorDebugHeapSegmentEnum puede incluir regiones de memoria vacías o reservadas.

El objeto de interfaz ICorDebugHeapSegmentEnum es un enumerador estándar derivado de la interfaz ICorDebugEnum que permite enumerar COR_SEGMENT objetos. Cada objeto COR_SEGMENT proporciona información sobre el intervalo de memoria de un segmento determinado, junto con la generación de los objetos en ese segmento.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versiones de .NET Framework: disponible a partir de la versión 4.5

Consulte también