提供基于其版本号返回公共语言运行时(CLR)的特定版本、列出所有已安装的 CLR、列出指定进程中加载的所有运行时、发现用于编译程序集的 CLR 版本、退出具有干净运行时关闭的进程以及查询旧版 API 绑定的方法。
Methods
| 方法 | Description |
|---|---|
| EnumerateInstalledRuntimes 方法 | 返回一个枚举,该枚举包含计算机上安装的每个 CLR 版本的有效 ICLRRuntimeInfo 接口指针。 |
| EnumerateLoadedRuntimes 方法 | 返回一个枚举,该枚举包含给定进程中加载的每个 CLR 的有效 ICLRRuntimeInfo 接口指针。 此方法取代 GetVersionFromProcess。 |
| ExitProcess 方法 | 尝试正常关闭所有加载的运行时,然后终止进程。 取代 CorExitProcess 函数。 |
| GetRuntime 方法 | 获取对应于特定 CLR 版本的 ICLRRuntimeInfo 接口。 此方法取代了与 STARTUP_LOADER_SAFEMODE 标志一起使用的 CorBindToRuntimeEx 函数。 |
| GetVersionFromFile 方法 | 获取程序集的原始 .NET Framework 编译版本(存储在元数据中),给定其文件路径。 此方法取代 GetFileVersion。 |
| QueryLegacyV2RuntimeBinding 方法 | 返回一个接口,该接口表示旧激活策略已绑定到的运行时,例如,通过使用useLegacyV2RuntimeActivationPolicy元素配置文件条目上的<startup>属性、直接使用旧激活 API 或调用 ICLRRuntimeInfo::BindAsLegacyV2Runtime 方法。 |
| RequestRuntimeLoadedNotification 方法 | 首次加载 CLR 版本但尚未启动时,保证对指定函数指针的回调。 此方法取代 LockClrVersion |
注解
获取此接口实例的唯一方法是调用 CLRCreateInstance 函数,如下所示:
ICLRMetaHost *pMetaHost = NULL;
HRESULT hr = CLRCreateInstance(CLSID_CLRMetaHost,
IID_ICLRMetaHost, (LPVOID*)&pMetaHost);
要求
平台:请参阅系统要求。
页眉: MetaHost.h
图书馆: 作为资源包含在 MSCorEE.dll
.NET Framework 版本: 自 4 起可用