CreateDebuggingInterfaceFromVersionEx 函数

接受从 CreateVersionStringFromModule 函数返回的公共语言运行时 (CLR) 版本字符串,并返回相应的调试器接口(通常 为 ICorDebug)。

语法

HRESULT CreateDebuggingInterfaceFromVersionEx (
    [in] int iDebuggerVersion,
    [in] LPCWSTR szDebuggeeVersion,
    [out] IUnknown** ppCordb,
);

参数

iDebuggerVersion
[in]调试器所需的接口版本。

szDebuggeeVersion
[in]目标调试对象中 CLR 的版本字符串,由 CreateVersionStringFromModule 函数返回。

ppCordb
[out]指向指向 COM 对象的指针的指针(IUnknown)。 在返回 ICorDebug 对象之前,此对象将被强制转换为 ICorDebug 对象。

返回值

S_OK
ppCordb 引用实现 ICorDebug 接口接口 的有效对象。

E_INVALIDARG
要么szDebuggeeVersionppCordb为 null。

CORDBG_E_DEBUG_COMPONENT_MISSING
无法找到 CLR 调试所需的组件。 在目标 CoreCLR.dll所在的目录中找不到mscordbi.dll或 mscordaccore.dll

CORDBG_E_INCOMPATIBLE_PROTOCOL
mscordbi.dll 或 mscordaccore.dll 与目标 CoreCLR.dll的版本不同。

E_FAIL (或其他 E_ 返回代码)
无法返回 ICorDebug 接口

注解

返回的接口提供用于在目标进程中附加到 CLR 并调试 CLR 正在运行的托管代码的工具。

要求

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

标头: dbgshim.h

库: dbgshim.dll、libdbgshim.so、libdbgshim.dylib

.NET 版本: 自 .NET Core 2.1 起可用