ICorDebugProcess2::GetReferenceValueFromGCHandle 方法

获取一个引用指针,该指针指向具有垃圾回收句柄的指定托管对象。

HRESULT GetReferenceValueFromGCHandle (
    [in]  UINT_PTR                 handle,
    [out] ICorDebugReferenceValue  **pOutValue
);

参数

  • handle
    [in] 一个指针,它指向具有垃圾回收句柄的托管对象。 此值是一个 IntPtr 对象,可通过托管对象的 GCHandle 进行检索。

  • pOutValue
    [out] 一个指向 ICorDebugReferenceValue 对象地址的指针,该对象表示对指定托管对象的引用。

备注

请勿将返回的引用值和垃圾回收引用值相混淆。

返回的引用的行为类似于正常引用。 当在断点后继续执行代码时,将禁用返回的引用。 该引用值的生存期不会影响目标对象的生存期。

注意注意

GetReferenceValueFromGCHandle 方法不对句柄进行验证。因此,如果传递的句柄无效,则 GetReferenceValueFromGCHandle 方法便可能会损坏调试器和正在调试的代码。

要求

**平台:**请参见 .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

请参见

参考

ICorDebugProcess2 接口

ICorDebugProcess 接口