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 起可用