CreateDebuggingInterfaceFromVersion 函数 (.NET Framework)

基于指定的版本信息创建 ICorDebug 对象。

此函数在 .NET Framework 4 中已弃用。 若要获取公共语言运行时 (CLR) 2.0 的接口,请使用 ICLRRuntimeInfo::GetInterface 方法,并指定类标识符 CLSID_CLRDebuggingLegacy 和接口标识符 IID_ICorDebug。 若要获取 CLR 4 或更高版本的接口,请调用 CLRCreateInstance 函数,并指定类标识符 CLSID_CLRDebugging 和接口标识符 IID_ICLRDebugging。

语法

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

参数

iDebuggerVersion
[in] 调试器应使用的 ICorDebug 的版本。 要了解相关有效值,请参阅 CorDebugInterfaceVersion 枚举。

szDebuggeeVersion
[in] 与要调试的应用程序或进程关联的公共语言运行时版本。 有关检索此值的信息,请参阅 GetVersionFromProcessGetRequestedRuntimeVersion 方法。

ppCordb
[out] 接收指向 ICorDebug 对象的指针的位置。

返回值

除以下值外,此方法还将返回 WinError.h 文件中定义的标准 COM 错误代码。

返回代码 说明
S_OK 该方法已成功完成。
E_INVALIDARG szDebuggeeVersionppCordb 为 NULL,或版本字符串不正确。

备注

参数 szDebuggeeVersion 映射到相应版本的 MSCorDbi.dll。

要求

平台:请参阅系统要求

标头:MSCorEE.h

库:MSCorEE.dll

.NET Framework 版本:自 2.0 起可用

另请参阅