Freigeben über

ICLRRuntimeInfo::GetInterface-Methode

  • Artikel

Lädt die CLR in den aktuellen Prozess und gibt Runtimeschnittstellenzeiger wie ICLRRuntimeHost, ICLRStrongName und IMetaDataDispenserEx zurück.

Diese Methode ersetzt im Abschnitt Veraltete CLR-Hostingfunktionen alle CorBindTo*-Funktionen.

Syntax

HRESULT GetInterface(  
[in]  REFCLSID rclsid,  
[in]  REFIID   riid,  
[out, iid_is(riid), retval] LPVOID *ppUnk);

Parameter

rclsid
[in] Die CLSID-Schnittstelle für die Co-Klasse.

riid
[in] Die IID der angeforderten rclsid-Schnittstelle.

ppUnk
[out] Ein Zeiger auf die abgefragte Schnittstelle.

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 ppUnk ist NULL.
E_OUTOFMEMORY Es ist nicht genügend Arbeitsspeicher verfügbar, um die Anforderung zu verarbeiten.
CLR_E_SHIM_LEGACYRUNTIMEALREADYBOUND Eine andere Runtime war bereits an die Legacy-CLR-Aktivierungsrichtlinie (Version 2) gebunden.

Bemerkungen

Diese Methode bewirkt, dass die CLR geladen, aber nicht initialisiert wird.

In der folgenden Tabelle sind die unterstützten Kombinationen für rclsid und aufgeführt riid.

rclsid riid
CLSID_CorMetaDataDispenser IID_IMetaDataDispenser, IID_IMetaDataDispenserEx
CLSID_CorMetaDataDispenserRuntime IID_IMetaDataDispenser, IID_IMetaDataDispenserEx
CLSID_CorRuntimeHost IID_ICorRuntimeHost
CLSID_CLRRuntimeHost IID_ICLRRuntimeHost
CLSID_TypeNameFactory IID_ITypeNameFactory
CLSID_CLRDebuggingLegacy IID_ICorDebug
CLSID_CLRStrongName IID_ICLRStrongName

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

Siehe auch