ICLRMetaHost – rozhraní

Poskytuje metody, které vrací konkrétní verzi modulu CLR (Common Language Runtime) na základě čísla verze, vypíše všechny nainstalované moduly CLR, zobrazí seznam všech modulů runtime načtených v zadaném procesu, zjistí verzi CLR použitou ke kompilaci sestavení, ukončí proces s čistým vypnutím modulu runtime a dotazuje starší vazbu rozhraní API.

Methods

Metoda Description
EnumerateInstalledRuntimes – metoda Vrátí výčet, který obsahuje platný ukazatel rozhraní ICLRRuntimeInfo pro každou verzi CLR nainstalovanou v počítači.
EnumerateLoadedRuntimes – metoda Vrátí výčet, který obsahuje platný ukazatel rozhraní ICLRRuntimeInfo pro každý CLR načtený v daném procesu. Tato metoda nahrazuje GetVersionFromProcess.
ExitProcess – metoda Pokusy o řádné vypnutí všech načtených modulů runtime a následné ukončení procesu. Nahrazuje funkci CorExitProcess .
GetRuntime – metoda Získá ICLRRuntimeInfo rozhraní, které odpovídá konkrétní verzi CLR. Tato metoda nahrazuje CorBindToRuntimeEx funkci použitou s příznakem STARTUP_LOADER_SAFEMODE .
GetVersionFromFile – metoda Získá původní verzi kompilace rozhraní .NET Framework sestavení (uloženou v metadatech) vzhledem k jeho cestě k souboru. Tato metoda nahrazuje GetFileVersion.
QueryLegacyV2RuntimeBinding – metoda Vrátí rozhraní, které představuje modul runtime, ke kterému byly vázány starší zásady aktivace, například pomocí atributu useLegacyV2RuntimeActivationPolicy<startup> pro položku konfiguračního souboru elementu, přímým použitím starších rozhraní API aktivace nebo voláním ICLRRuntimeInfo::BindAsLegacyV2Runtime metoda.
RequestRuntimeLoadedNotification – metoda Zaručuje zpětné volání zadanému ukazateli funkce při prvním načtení verze CLR, ale ještě není spuštěno. Tato metoda nahrazuje LockClrVersion.

Poznámky

Jediným způsobem, jak získat instanci tohoto rozhraní, je voláním funkce CLRCreateInstance následujícím způsobem:

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

Požadavky

Platformy: Viz požadavky na systém.

Záhlaví: MetaHost.h

Knihovna: Zahrnutý jako prostředek v MSCorEE.dll

Verze rozhraní .NET Framework: K dispozici od 4

Viz také