ICorDebugProcess5::EnumerateHeap (Método)

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

Syntax

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.

Observaciones

Antes de llamar ICorDebugProcess5::EnumerateHeap 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, devuelve ICorDebugProcess5::EnumerateHeapE_FAIL si se adjunta 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 COR_HEAPOBJECT objetos. 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 rooteados por ningún objeto, pero que aún no han sido recopilados por el recolector de elementos no utilizados.

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)