Share via

Метод 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 экземпляров, которые предоставляют сведения об объектах, которые не являются корневыми для какого-либо объекта, но еще не были собраны сборщиком мусора.

Требования

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

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

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

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

См. также раздел