Udostępnij przez

ICLRMetaHost, interfejs

Udostępnia metody, które zwracają określoną wersję środowiska uruchomieniowego języka wspólnego (CLR) na podstawie jego numeru wersji, wyświetlają listę wszystkich zainstalowanych środowisk uruchomieniowych, wyświetlają listę wszystkich środowisk uruchomieniowych załadowanych w określonym procesie, odnajdują wersję środowiska CLR używaną do kompilowania zestawu, zamykają proces z czystym zamknięciem środowiska uruchomieniowego i wysyłają zapytania o starsze powiązanie interfejsu API.

Methods

Metoda Description
EnumerateInstalledRuntimes, metoda Zwraca wyliczenie zawierające prawidłowy wskaźnik interfejsu ICLRRuntimeInfo dla każdej wersji środowiska CLR zainstalowanej na komputerze.
EnumerateLoadedRuntimes, metoda Zwraca wyliczenie zawierające prawidłowy wskaźnik interfejsu ICLRRuntimeInfo dla każdego środowiska CLR załadowanego w danym procesie. Ta metoda zastępuje metodę GetVersionFromProcess.
ExitProcess, metoda Próbuje bezpiecznie zamknąć wszystkie załadowane środowiska uruchomieniowe, a następnie zakończyć proces. Zastępuje funkcję CorExitProcess .
GetRuntime, metoda Pobiera interfejs ICLRRuntimeInfo odpowiadający określonej wersji środowiska CLR. Ta metoda zastępuje funkcję CorBindToRuntimeEx używaną z flagą STARTUP_LOADER_SAFEMODE .
GetVersionFromFile, metoda Pobiera oryginalną wersję kompilacji .NET Framework zestawu (przechowywaną w metadanych), biorąc pod uwagę ścieżkę pliku. Ta metoda zastępuje metodę GetFileVersion.
QueryLegacyV2RuntimeBinding, metoda Zwraca interfejs reprezentujący środowisko uruchomieniowe, do którego zostały powiązane starsze zasady aktywacji, na przykład za pomocą atrybutu useLegacyV2RuntimeActivationPolicy we <startup> wpisie pliku konfiguracji elementu, przy użyciu bezpośredniego użycia starszych interfejsów API aktywacji lub wywołując metodę ICLRRuntimeInfo::BindAsLegacyV2Runtime.
RequestRuntimeLoadedNotification, metoda Gwarantuje wywołanie zwrotne do określonego wskaźnika funkcji po pierwszym załadowaniu wersji środowiska CLR, ale nie zostało jeszcze uruchomione. Ta metoda zastępuje LockClrVersion

Uwagi

Jedynym sposobem uzyskania wystąpienia tego interfejsu jest wywołanie funkcji CLRCreateInstance w następujący sposób:

ICLRMetaHost *pMetaHost = NULL;
HRESULT hr = CLRCreateInstance(CLSID_CLRMetaHost,
                   IID_ICLRMetaHost, (LPVOID*)&pMetaHost);

Requirements

Platformy: Zobacz Wymagania systemowe.

Nagłówek: MetaHost.h

Biblioteka: Uwzględnione jako zasób w MSCorEE.dll

Wersje programu .NET Framework: Dostępne od 4

Zobacz także

  • Last updated on