Methode ICLRMetaHost::GetRuntime

Artikel
05/10/2023

Hiermee haalt u de ICLRRuntimeInfo-interface op die overeenkomt met een bepaalde versie van de COMMON Language Runtime (CLR). Deze methode vervangt de functie CorBindToRuntimeEx die wordt gebruikt met de vlag STARTUP_LOADER_SAFEMODE .

Syntaxis

HRESULT GetRuntime (  
    [in] LPCWSTR pwzVersion,  
    [in] REFIID riid,  
    [out,iid_is(riid), retval] LPVOID *ppRuntime  
);

Parameters

pwzVersion
[in] De .NET Framework compilatieversie opgeslagen in de metagegevens, in de indeling 'vA. B[. X]". A, B en X zijn decimale getallen die overeenkomen met de primaire versie, de secundaire versie en het buildnummer.

Notitie

Deze parameter moet overeenkomen met de mapnaam voor de .NET Framework versie, zoals deze wordt weergegeven onder C:\Windows\Microsoft.NET\Framework of C:\Windows\Microsoft.NET\Framework64.

Voorbeeldwaarden zijn 'v1.0.3705', 'v1.1.4322', 'v2.0.50727' en 'v4.0'. X', waarbij X afhankelijk is van het buildnummer dat is geïnstalleerd. Het voorvoegsel 'v' is vereist.

riid
[in] De id voor de gewenste interface. Momenteel is de enige geldige waarde voor deze parameter IID_ICLRRuntimeInfo.

ppRuntime
[uit] Een verwijzing naar de interface ICLRRuntimeInfo die overeenkomt met de aangevraagde runtime.

Retourwaarde

Deze methode retourneert de volgende specifieke HRESULT's en HRESULT-fouten die wijzen op een fout in de methode.

HRESULT	Beschrijving
S_OK	De methode is voltooid.
E_POINTER	`pwzVersion` of `ppRuntime` is null.

Opmerkingen

Deze methode communiceert consistent met verouderde interfaces zoals de ICorRuntimeHost-interface en verouderde functies, zoals de afgeschafte CorBindTo* functies (zie Afgeschafte CLR-hostingfuncties in de .NET Framework 2.0-hosting-API). Dat wil gezegd dat runtimes die zijn geladen met de verouderde API zichtbaar zijn voor de nieuwe API en runtimes die met de nieuwe API zijn geladen, zichtbaar zijn voor de verouderde API.

Vereisten

Platforms: Zie Systeemvereisten.

Header: MetaHost.h

Bibliotheek: Opgenomen als een resource in MSCorEE.dll

.NET Framework versies: beschikbaar sinds 4

Delen via