ICorDebugHeapValue2::CreateHandle 方法

为此 ICorDebugHeapValue2 对象表示的堆值创建指定类型的句柄。

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

参数

• type
  [in] CorDebugHandleType 枚举的值，指定要创建的句柄的类型。

• ppHandle
  [out] 一个指向 ICorDebugHandleValue 对象地址的指针，该对象表示此堆值的新句柄。

备注

句柄将在与堆值关联的应用程序域中创建，并且，如果应用程序域被卸载，该句柄将变为无效。

为相同堆值多次调用此函数将创建多个句柄。 由于句柄会影响垃圾回收器的性能，因此调试器本身应将一次处于活动状态的句柄数限制为相对较小的数目（大约 256 个）。

要求

**平台：**请参见 .NET Framework 系统要求。

头文件： CorDebug.idl、CorDebug.h

**库：**CorGuids.lib

**.NET Framework 版本：**4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0

请参见

参考

ICorDebugHeapValue2 接口