ICLRMetaHost 接口

提供基于其版本号返回公共语言运行时(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 起可用

另请参阅