接受从 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
要么szDebuggeeVersion
ppCordb
为 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 起可用