ICorDebugProcess5::EnumerateHeapRegions (Método)
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