ICLRMetaHost — Interfejs

  • Artykuł

Udostępnia metody zwracające określoną wersję środowiska uruchomieniowego języka wspólnego (CLR) na podstawie jego numeru wersji, wyświetlanie listy wszystkich zainstalowanych żądań CLRs, wyświetlanie listy wszystkich środowisk uruchomieniowych załadowanych w określonym procesie, odnajdywanie wersji clR używanej do kompilowania zestawu, kończenie procesu z czystym zamknięciem środowiska uruchomieniowego i wykonywanie zapytań względem starszego powiązania interfejsu API.

Metody

Metoda Opis
EnumerateInstalledRuntimes, metoda Zwraca wyliczenie zawierające prawidłowy wskaźnik interfejsu ICLRRuntimeInfo dla każdej wersji 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 całkowicie wyłączyć wszystkie załadowane środowiska uruchomieniowe, a następnie kończy proces. Zastępuje funkcję CorExitProcess .
GetRuntime, metoda Pobiera interfejs ICLRRuntimeInfo odpowiadający określonej wersji CLR. Ta metoda zastępuje funkcję CorBindToRuntimeEx używaną z flagą STARTUP_LOADER_SAFEMODE .
GetVersionFromFile, metoda Pobiera oryginalną wersję kompilacji zestawu .NET Framework (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 przy użyciu atrybutu useLegacyV2RuntimeActivationPolicy we wpisie pliku konfiguracji elementu uruchamiania>, przez bezpośrednie użycie starszych interfejsów API aktywacji lub przez wywołanie metody ICLRRuntimeInfo::BindAsLegacyV2Runtime.<
RequestRuntimeLoadedNotification, metoda Gwarantuje wywołanie zwrotne do określonego wskaźnika funkcji, gdy wersja clR jest najpierw załadowana, ale nie została jeszcze uruchomiona. Ta metoda zastępuje klasę 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);

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: MetaHost.h

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

wersje .NET Framework: dostępne od 4

Zobacz też