Share via

Метод ICorDebugHeapValue2::CreateHandle

  • Статья

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

Синтаксис

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

Параметры

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

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

Комментарии

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

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

Требования

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

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

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

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