Delen via

ICLRMetaHost-interface

  • Artikel

Biedt methoden die een specifieke versie van de Common Language Runtime (CLR) retourneren op basis van het versienummer, alle geïnstalleerde CLR's weergeven, alle runtimes weergeven die in een opgegeven proces zijn geladen, de CLR-versie detecteren die wordt gebruikt voor het compileren van een assembly, een proces afsluiten met een schone runtime afsluiten en een query uitvoeren op verouderde API-binding.

Methoden

Methode Beschrijving
Methode EnumerateInstalledRuntimes Retourneert een opsomming die een geldige ICLRRuntimeInfo-interfaceaanwijzer bevat voor elke CLR-versie die op een computer is geïnstalleerd.
Methode EnumerateLoadedRuntimes Retourneert een opsomming die een geldige ICLRRuntimeInfo-interfaceaanwijzer bevat voor elke CLR die in een bepaald proces wordt geladen. Deze methode vervangt GetVersionFromProcess.
Methode ExitProcess Probeert alle geladen runtimes probleemloos af te sluiten en beëindigt vervolgens het proces. Vervangt de functie CorExitProcess .
Methode GetRuntime Hiermee haalt u de ICLRRuntimeInfo-interface op die overeenkomt met een bepaalde CLR-versie. Deze methode vervangt de functie CorBindToRuntimeEx die wordt gebruikt met de vlag STARTUP_LOADER_SAFEMODE .
Methode GetVersionFromFile Hiermee haalt u de oorspronkelijke .NET Framework compilatieversie van de assembly op (opgeslagen in de metagegevens), op basis van het bestandspad. Deze methode vervangt GetFileVersion.
Methode QueryLegacyV2RuntimeBinding Retourneert een interface die een runtime vertegenwoordigt waaraan verouderd activeringsbeleid is gebonden, bijvoorbeeld met behulp van het useLegacyV2RuntimeActivationPolicy kenmerk op de vermelding van het configuratiebestand voor het< opstartelement>, door direct gebruik van de verouderde activerings-API's of door de methode ICLRRuntimeInfo::BindAsLegacyV2Runtime aan te roepen.
Methode RequestRuntimeLoadedNotification Hiermee wordt een callback naar de opgegeven functieaanwijzer gegarandeerd wanneer een CLR-versie voor het eerst wordt geladen, maar nog niet is gestart. Deze methode vervangt LockClrVersion

Opmerkingen

De enige manier om een exemplaar van deze interface op te halen, is door de functie CLRCreateInstance als volgt aan te roepen:

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

Vereisten

Platforms: Zie Systeemvereisten.

Header: MetaHost.h

Bibliotheek: Opgenomen als een resource in MSCorEE.dll

.NET Framework versies: beschikbaar sinds 4

Zie ook