ICLRRuntimeInfo::GetInterface Method

Betölti a CLR-t az aktuális folyamatba, és visszaadja a futtatókörnyezeti felület mutatóit, például ICLRRuntimeHost, ICLRStrongName és IMetaDataDispenserEx.

Ez a módszer felülírja az CorBindToelavult CLR Hosting Functions szakaszban található összes * függvényt.

Syntax

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

Parameters

rclsid [in] A társosztály CLSID-felülete.

riid [in] A kért rclsid felület IID azonosítója.

ppUnk [kifelé] Mutató a lekérdezett felületre.

Return Value

Ez a metódus a következő specifikus HRESULT-eket, valamint a metódushibát jelző HRESULT-hibákat adja vissza.

HRESULT	Description
S_OK	A metódus sikeresen befejeződött.
E_POINTER	ppUnk null értékű.
E_OUTOFMEMORY	Nincs elegendő memória a kérés kezeléséhez.
CLR_E_SHIM_LEGACYRUNTIMEALREADYBOUND	Egy másik futtatókörnyezet már a régi CLR 2-es verziójú aktiválási szabályzatához volt kötve.

Remarks

Ez a módszer a CLR betöltését okozza, de nem inicializálódik.

Az alábbi táblázat a támogatott kombinációkat rclsidriidmutatja be.

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

Requirements

Platformok: Lásd a rendszerkövetelményeket.

Header: MetaHost.h

Könyvtár: Erőforrásként szerepel a MSCorEE.dll

.NET-keretrendszerverziók: 4 óta elérhető

See also

• ICLRRuntimeInfo Interface
• Hosting Interfaces
• Hosting