ICorDebugProcess2::GetReferenceValueFromGCHandle 方法

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

Syntax

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

参数

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

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

注解

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

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

注释

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

要求

平台: 请参阅 .NET 支持的作系统

页眉: CorDebug.idl、CorDebug.h

图书馆: CorGuids.lib

.NET 版本: 自 .NET Framework 2.0 起可用