ICLRRuntimeInfo::GetInterface-Methode

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);

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.

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.

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

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: MetaHost.h

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

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