Sdílet prostřednictvím

ICLRMetaHost – rozhraní

  • Článek

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

Metody

Metoda Popis
EnumerateInstalledRuntimes – metoda Vrátí výčet, který obsahuje platný ukazatel rozhraní ICLRRuntimeInfo pro každou verzi CLR, která je nainstalována v počítači.
EnumerateLoadedRuntimes – metoda Vrátí výčet, který obsahuje platný ukazatel rozhraní ICLRRuntimeInfo pro každý CLR, který je načten v daném procesu. Tato metoda nahrazuje GetVersionFromProcess.
ExitProcess – metoda Pokusí se řádně vypnout všechny načtené moduly runtime a pak proces ukončí. Nahrazuje funkci CorExitProcess .
GetRuntime – metoda Získá ICLRRuntimeInfo rozhraní, které odpovídá konkrétní verzi CLR. Tato metoda nahrazuje funkci CorBindToRuntimeEx použitou s příznakem STARTUP_LOADER_SAFEMODE .
GetVersionFromFile – metoda Získá původní verzi kompilace sestavení rozhraní .NET Framework (uložená 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í useLegacyV2RuntimeActivationPolicy atributu v <položce konfiguračního souboru elementu startup>, přímým použitím starších aktivačních rozhraní API nebo voláním metody ICLRRuntimeInfo::BindAsLegacyV2Runtime metody.
RequestRuntimeLoadedNotification – metoda Zaručuje zpětné volání zadaného ukazatele funkce při prvním načtení verze CLR, ale ještě nespustit. Tato metoda nahrazuje LockClrVersion.

Poznámky

Jediným způsobem, jak získat instanci tohoto rozhraní, je volání 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

Knihovny: Zahrnuto jako prostředek v MSCorEE.dll

Verze rozhraní .NET Framework: K dispozici od 4

Viz také