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 起可用