Share via

ICLRRuntimeInfo::GetInterface, méthode

  • Article

Charge le CLR dans le processus actuel et renvoie des pointeurs d’interface d’exécution, comme ICLRRuntimeHost, ICLRStrongName et IMetaDataDispenser.

Cette méthode remplace toutes les fonctions CorBindTo* dans la section Fonctions d’hébergement du CLR déconseillées.

Syntaxe

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

Paramètres

rclsid
[in] Interface CLSID de la coclasse.

riid
[in] IID de l’interface rclsid demandée.

ppUnk
[out] Pointeur vers l’interface interrogée.

Valeur de retour

Cette méthode retourne les HRESULT spécifiques suivants ainsi que les erreurs HRESULT indiquant l'échec de la méthode.

HRESULT Description
S_OK La commande s'est correctement terminée.
E_POINTER ppUnk a la valeur null.
E_OUTOFMEMORY Mémoire disponible insuffisante pour traiter la requête.
CLR_E_SHIM_LEGACYRUNTIMEALREADYBOUND Un autre runtime était déjà lié à la stratégie d’activation héritée du CLR version 2.

Notes

Cette méthode entraîne le chargement du CLR, mais pas son initialisation.

Le tableau suivant présente les combinaisons prises en charge pour rclsid et 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

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : MetaHost.h

Bibliothèque : incluse en tant que ressource dans MsCorEE.dll

Versions de .NET Framework : Disponibles depuis 4

Voir aussi