ICLRMetaHost::GetRuntime-Methode

Artikel
08/10/2011

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

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, die der Hauptversion, der Nebenversion bzw. der Buildnummer entsprechen.

Hinweis

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

Beispielwerte sind "v1.0.3705", "v1.1.4322", "v2.0.50727" und "v4.0.X", wobei X von der Nummer des installierten Builds abhängt. Das Präfix "v" ist erforderlich.
riid
[in] Der Bezeichner für die gewünschte Schnittstelle. Der einzige derzeit gültige Wert für diesen Parameter ist IID_ICLRRuntimeInfo.
ppRuntime
[out] Ein Zeiger auf die entsprechende ICLRRuntimeInfo-Schnittstelle, die der geforderten Runtime entspricht.

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

Rückgabewert

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

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

Hinweise

Diese Methode interagiert gleichbleibend mit Legacyschnittstellen, z. B. der ICorRuntimeHost-Schnittstelle, und Legacy-Funktionen, wie z. B. den veralteten CorBindTo*-Funktionen (siehe Hosten globaler statischer .NET Framework 1.1- und 2.0-Funktionen in der .NET Framework 2.0-Hosting-API). Das heißt, mit der Legacy-API geladene Laufzeiten sind für die neue API sichtbar, und Laufzeiten, die mit der neuen API geladen werden, sind für die Legacy-API sichtbar. .