Compartir a través de

ICorDebugProcess5::EnumerateHeap (Método)

  • Artículo

Obtiene un enumerador para los objetos del montón gestionado.

Sintaxis

HRESULT EnumerateHeap(  
    [out] ICorDebugHeapEnum **ppObjects  
);

Parámetros

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

Comentarios

Antes de llamar al método ICorDebugProcess5::EnumerateHeap, 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 ICorDebugProcess5::EnumerateHeap devuelveE_FAIL si se asocia demasiado pronto en la duración del proceso, antes de asignar memoria para el montón administrado.

El objeto de interfaz ICorDebugHeapEnum es un enumerador estándar derivado de la interfaz ICorDebugEnum que permite enumerar objetos COR_SEGMENT. Este método rellena el objeto de colección ICorDebugHeapEnum con instancias de COR_HEAPOBJECT que proporcionan información sobre todos los objetos. La colección también puede incluir instancias de COR_HEAPOBJECT que proporcionan información sobre los objetos que no están modificados por ningún objeto, pero que el recolector de elementos no utilizados aún no ha recopilado.

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