Share via

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