Dela via

ICLRMetaHost-gränssnitt

  • Artikel

Innehåller metoder som returnerar en specifik version av CLR (Common Language Runtime) baserat på dess versionsnummer, listar alla installerade CLR:er, listar alla körningar som läses in i en angiven process, identifierar CLR-versionen som används för att kompilera en sammansättning, avsluta en process med en ren körningsavstängning och köra frågor mot äldre API-bindningar.

Metoder

Metod Beskrivning
EnumerateInstalledRuntimes-metod Returnerar en uppräkning som innehåller en giltig ICLRRuntimeInfo-gränssnittspekare för varje CLR-version som är installerad på en dator.
EnumerateLoadedRuntimes-metod Returnerar en uppräkning som innehåller en giltig ICLRRuntimeInfo-gränssnittspekare för varje CLR som läses in i en viss process. Den här metoden ersätter GetVersionFromProcess.
ExitProcess-metod Försöker stänga av alla inlästa körningar på ett smidigt sätt och avslutar sedan processen. Ersätter funktionen CorExitProcess .
GetRuntime-metod Hämtar gränssnittet ICLRRuntimeInfo som motsvarar en viss CLR-version. Den här metoden ersätter funktionen CorBindToRuntimeEx som används med flaggan STARTUP_LOADER_SAFEMODE .
GetVersionFromFile-metod Hämtar sammansättningens ursprungliga .NET Framework kompileringsversion (lagras i metadata) baserat på dess filsökväg. Den här metoden ersätter GetFileVersion.
QueryLegacyV2RuntimeBinding-metod Returnerar ett gränssnitt som representerar en körningsmiljö som en äldre aktiveringsprincip har bundits till, till exempel med hjälp useLegacyV2RuntimeActivationPolicy av attributet på <> startelementets konfigurationsfilpost, genom direkt användning av äldre aktiverings-API:er eller genom att anropa metoden ICLRRuntimeInfo::BindAsLegacyV2Runtime.
RequestRuntimeLoadedNotification-metod Garanterar ett återanrop till den angivna funktionspekaren när en CLR-version först läses in, men ännu inte har startats. Den här metoden ersätter LockClrVersion

Kommentarer

Det enda sättet att hämta en instans av det här gränssnittet är genom att anropa funktionen CLRCreateInstance på följande sätt:

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

Krav

Plattformar: Se Systemkrav.

Huvudet: MetaHost.h

Bibliotek: Ingår som en resurs i MSCorEE.dll

.NET Framework versioner: Tillgänglig sedan 4

Se även