Метод ICorDebugHeapValue2::CreateHandle

Создает дескриптор указанного типа для значения кучи, представленного этим объектом ICorDebugHeapValue2.

Синтаксис

HRESULT CreateHandle (
    [in] CorDebugHandleType      type,
    [out] ICorDebugHandleValue   **ppHandle
);

Параметры

type [in] Значение перечисления CorDebugHandleType, указывающее тип создаваемого дескриптора.

ppHandle [out] Указатель на адрес объекта ICorDebugHandleValue, представляющий новый дескриптор для этого значения кучи.

Замечания

Дескриптор будет создан в домене приложения, связанном со значением кучи, и станет недопустимым, если домен приложения выгрузится.

Несколько вызовов этой функции для одного значения кучи создают несколько дескрипторов. Так как дескрипторы влияют на производительность сборщика мусора, отладчик должен ограничиться относительно небольшим количеством дескрипторов (около 256), которые активны одновременно.

Требования

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

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

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

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