ICLRMetaHost::GetRuntime 方法

获取对应于公共语言运行时 (CLR) 的 ICLRRuntimeInfo 接口。 此方法取代与 STARTUP_LOADER_SAFEMODE 标志一起使用的 CorBindToRuntimeEx 函数。

HRESULT GetRuntime (
    [in] LPCWSTR pwzVersion,
    [in, REFIID riid,
    [out,iid_is(riid), retval] LPVOID *ppRuntime
);

参数

  • pwzVersion
    [in] 存储在元数据中的 .NET Framework 编译版本,格式为“vA.B[.X]”。 A、B 和 X 分别是与主版本、次版本和内部版本号对应的十进制数字。

    注意注意

    此参数必须与显示在 C:\Windows\Microsoft.NET\Framework 或 C:\Windows\Microsoft.NET\Framework64 下的 .NET Framework 版本目录名称相匹配。

    示例值为“v1.0.3705”、“v1.1.4322”、“v2.0.50727”和“v4.0.X”,其中 X 取决于安装的内部版本号。 “v”前缀是必需的。

  • riid
    [in] 所需接口的标识符。 当前,此参数的唯一有效值为 IID_ICLRRuntimeInfo。

  • ppRuntime
    [out] 一个指向对应于请求的运行时的 ICLRRuntimeInfo 接口的指针。

返回值

此方法将返回以下特定的 HRESULT 以及用于指示方法失败的 HRESULT 错误。

HRESULT

说明

S_OK

该方法成功完成。

E_POINTER

pwzVersion 或 ppRuntime 为 null。

备注

此方法一致地与旧接口(如 ICorRuntimeHost 接口)和旧函数(如弃用的 CorBindTo* 函数)交互(请参见 .NET Framework 2.0 承载 API 中的.NET Framework 1.1 和 2.0 承载全局静态函数)。 也就是说,用旧版 API 加载的运行时对新版 API 可见,并且用新版 API 加载的运行时对旧版 API 可见。 .

要求

**平台:**请参见 .NET Framework 系统要求

头文件: MetaHost.h

**库:**作为一项资源包含在 MSCorEE.dll 中

**.NET Framework 版本:**4

请参见

参考

ICLRMetaHost 接口

其他资源

.NET Framework 1.0 和 1.1 承载接口

.NET Framework 2.0 承载接口

.NET Framework 1.1 和 2.0 承载全局静态函数

承载(非托管 API 参考)