ICLRMetaHost::GetRuntime 方法

项目
08/12/2011

获取对应于公共语言运行时 (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 接口的指针。

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

返回值

此方法将返回以下特定的 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 可见。 .