ICorDebugProcess5::EnumerateHeapRegions (Método)

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

Syntax

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.

Observaciones

Antes de llamar ICorDebugProcess5::EnumerateHeapRegions al método , debe llamar al método ICorDebugProcess5::GetGCHeapInformation y examinar el valor del areGCStructuresValid campo 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 ICorDebugProcess5::EnumerateHeapRegions método devuelve E_FAIL si se adjunta demasiado pronto en la duración del proceso, antes de crear regiones de memoria.

Este método se garantiza para enumerar 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 de ese segmento.

Requisitos

Plataformas: Consulte Sistemas operativos compatibles con .NET.

Encabezado: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versiones de .NET: Disponible desde .NET Framework 4.5

Consulte también

• ICorDebugProcess5 (interfaz)