Метод ICorDebugProcess5::EnumerateHeap

Возвращает перечислитель для объектов в управляемой куче.

Синтаксис

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

Параметры

ppObject [out] Указатель на адрес объекта интерфейса ICorDebugHeapEnum , который является перечислителем для объектов, находящихся в управляемой куче.

Замечания

Перед вызовом ICorDebugProcess5::EnumerateHeap метода необходимо вызвать метод ICorDebugProcess5::GetGCHeapInformation и проверить значение areGCStructuresValid поля возвращаемого объекта COR_HEAPINFO , чтобы убедиться, что куча сборки мусора в текущем состоянии перечислена. Кроме того, возвращается, ICorDebugProcess5::EnumerateHeap если вы присоединяете E_FAIL слишком рано в течение всего времени существования процесса, прежде чем выделена память для управляемой кучи.

Объект интерфейса ICorDebugHeapEnum — это стандартный перечислитель, производный от интерфейса ICorDebugEnum, который позволяет перечислять объекты COR_HEAPOBJECT . Этот метод заполняет объект коллекции ICorDebugHeapEnumCOR_HEAPOBJECT экземплярами, предоставляющими сведения обо всех объектах. Коллекция также может включать COR_HEAPOBJECT экземпляры, предоставляющие сведения о объектах, которые не коренятся каким-либо объектом, но еще не были собраны сборщиком мусора.

Требования

Платформ: См. сведения о поддерживаемых операционных системах .NET.

Заголовок: CorDebug.idl, CorDebug.h

Библиотека: CorGuids.lib

Версии .NET: Доступно с версии .NET Framework 4.5

См. также

• Интерфейс ICorDebugProcess5