通过

ICLRMetaHost::GetRuntime 方法

  • 项目

获取 ICLRRuntimeInfo 接口，该接口对应于公共语言运行时 (CLR) 的特定版本。 此方法取代了与 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 是对应于主版本、次要版本和生成号的十进制数字。

备注

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

示例值为“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 中的已弃用的 CLR 托管函数）。 也就是说，使用旧 API 加载的运行时对新 API 可见，使用新 API 加载的运行时对旧 API 可见。

要求

平台：请参阅系统要求。

标头：MetaHost.h

库：作为资源包含在 MSCorEE.dll 中

.NET Framework 版本：自 4 起可用

另请参阅