ICLRMetaHost::GetRuntime-Methode

Artikel
06/05/2023

Ruft die ICLRRuntimeInfo-Schnittstelle ab, die einer bestimmten Version der Common Language Runtime (CLR) entspricht. Diese Methode ersetzt die Funktion CorBindToRuntimeEx, die mit dem Flag STARTUP_LOADER_SAFEMODE verwendet wird.

Syntax

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

Parameter

pwzVersion
[in] Die in den Metadaten gespeicherte .NET Framework-Kompilierungsversion im Format „vA.B[.X]“. A, B und X sind Dezimalzahlen, mit denen die Hauptversion, die Nebenversion und die Buildnummer angegeben werden.

Hinweis

Dieser Parameter muss mit dem Verzeichnisnamen für die .NET Framework-Version übereinstimmen, wie angezeigt unter „C:\Windows\Microsoft.NET\Framework“ oder „C:\Windows\Microsoft.NET\Framework64“.

Beispielwerte sind „v1.0.3705“, „v1.1.4322“, „v2.0.50727“ und „v4.0.X“, wobei X von der installierten Buildnummer abhängt. Das Präfix „v“ ist erforderlich.

riid
[in] Der Bezeichner für die gewünschte Schnittstelle. Zurzeit lautet der einzige gültige Wert für diesen Parameter „IID_ICLRRuntimeInfo“.

ppRuntime
[out] Ein Zeiger auf die ICLRRuntimeInfo-Schnittstelle, die der angeforderten Runtime entspricht.

Rückgabewert

Diese Methode gibt die folgenden spezifischen HRESULTs sowie HRESULT-Fehler zurück, die Methodenfehler anzeigen.

HRESULT	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich abgeschlossen.
E_POINTER	`pwzVersion` oder `ppRuntime` ist NULL.

Bemerkungen

Diese Methode interagiert konsistent mit Legacyschnittstellen wie der ICorRuntimeHost-Schnittstelle und Legacyfunktionen wie den veralteten CorBindTo*-Funktionen (siehe Veraltete CLR-Hostingfunktionen in der .NET Framework 2.0-Hosting-API). Das bedeutet Folgendes: Runtimes, die mit der alten API geladen werden, sind für die neue API sichtbar, und Runtimes, die mit der neuen API geladen werden, sind für die alte API sichtbar.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: MetaHost.h

Bibliothek: Als Ressource in „MsCorEE.dll“ enthalten.

.NET Framework-Versionen: Seit Version 4 verfügbar

Freigeben über