Поделиться через


Метод 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 . Этот метод заполняет объект коллекции ICorDebugHeapEnum COR_HEAPOBJECT экземплярами, предоставляющими сведения обо всех объектах. Коллекция также может включать COR_HEAPOBJECT экземпляры, предоставляющие сведения о объектах, которые не коренятся каким-либо объектом, но еще не были собраны сборщиком мусора.

Требования

Платформы: см. раздел Требования к системе.

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

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

версии платформа .NET Framework: Доступно с версии 4.5

См. также