Интерфейс ICLRMetaHost

Предоставляет методы, возвращающие определенную версию среды CLR на основе его номера версии, перечисляют все установленные среды CLR, перечисляют все среды выполнения, загруженные в указанный процесс, обнаруживают версию СРЕДЫ CLR, используемую для компиляции сборки, выход из процесса с чистым завершением работы среды выполнения и запросом устаревшей привязки API.

Методы

Метод	Description
Метод EnumerateInstalledRuntimes	Возвращает перечисление, содержащее допустимый указатель интерфейса ICLRRuntimeInfo для каждой версии СРЕДЫ CLR, установленной на компьютере.
Метод EnumerateLoadedRuntimes	Возвращает перечисление, содержащее допустимый указатель интерфейса ICLRRuntimeInfo для каждого среды CLR, загруженного в данный процесс. Этот метод заменяет GetVersionFromProcess.
Метод ExitProcess	Пытается завершить работу всех загруженных сред выполнения, а затем завершает процесс. Заменяет функцию CorExitProcess .
Метод GetRuntime	Возвращает интерфейс ICLRRuntimeInfo , соответствующий определенной версии СРЕДЫ CLR. Этот метод заменяет функцию CorBindToRuntimeEx , используемую с флагом STARTUP_LOADER_SAFEMODE .
Метод 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

См. также

• Интерфейсы размещения
• Хостинг