ICorDebugProcess2::GetReferenceValueFromGCHandle 方法

更新:2007 年 11 月

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

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

参数

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

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

备注

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

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

说明:

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

要求

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

**头文件:**CorDebug.idl

**库:**CorGuids.lib

**.NET Framework 版本:**3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0

请参见

参考

ICorDebugProcess2

ICorDebugProcess