CreateDebuggingInterfaceFromVersion 函数 (.NET Framework)

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

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

Syntax

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

参数

iDebuggerVersion
[in]调试器预期的版本 ICorDebug 。 有关有效值,请参阅 CorDebugInterfaceVersion 枚举。

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

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

返回值

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

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

注解

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

要求

平台: 请参阅 系统要求

页眉: MSCorEE.h

库: MSCorEE.dll

.NET Framework 版本: 自 2.0 起可用

另请参阅