ICorDebugProcess2::GetReferenceValueFromGCHandle 方法

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

语法

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

参数

handle [in]指向具有垃圾回收句柄的托管对象的指针。 此值为 IntPtr 对象,可以从托管对象的 GCHandle 中检索。

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

注解

不要将返回的引用值与垃圾回收引用值混淆。

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

备注

GetReferenceValueFromGCHandle 方法不验证句柄。 因此,如果传递无效句柄,GetReferenceValueFromGCHandle 方法可能会损坏调试器以及正在调试的代码。

要求

平台:请参阅系统要求

标头:CorDebug.idl、CorDebug.h

库:CorGuids.lib

.NET Framework 版本:自 2.0 起可用