ICLRRuntimeInfo::GetInterface, méthode

  • Article

Charge le CLR dans le processus actuel et retourne les pointeurs d'interface runtime, tels que ICLRRuntimeHost, ICLRStrongName et IMetaDataDispenser.

Cette méthode remplace toutes les fonctions CorBindTo* dans la section Fonctions statiques globales de l'hébergement .NET Framework 1.1 et 2.0.

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

Paramètres

  • rclsid
    [in] Interface CLSID pour 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 qui indiquent l'échec de la méthode.

HRESULT

Description

S_OK

La méthode s'est correctement terminée.

E_POINTER

ppUnk a la valeur null.

E_OUTOFMEMORY

La mémoire n'est pas suffisante pour gérer la demande.

CLR_E_SHIM_LEGACYRUNTIMEALREADYBOUND

Une exécution différente a déjà été liée à la stratégie d'activation héritée CLR version 2.

Notes

Cette méthode provoque le chargement du CLR, mais pas son initialisation.

Le tableau suivant affiche les combinaisons prises en charge pour les commandes 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_CLRStrongName

IID_ICLRStrongName

Configuration requise

Plateformes : consultez Configuration requise du .NET Framework.

En-tête : MetaHost.h

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

Versions du .NET Framework : 4

Voir aussi

Référence

ICLRRuntimeInfo, interface

Autres ressources

Interfaces d'hébergement

Hébergement (Référence des API non managées)

Historique des modifications

Date

Historique

Motif

Octobre 2010

A ajouté CLR_E_SHIM_LEGACYRUNTIMEALREADYBOUND à des codes de retour.

Résolution des bogues de contenu.

Septembre 2010

A corrigé plusieurs entrées de riid.

Commentaires client.

Juin 2010

A corrigé le riid susceptible d'être utilisé en combinaison avec CLSID_CLRRuntimeHost.

Résolution des bogues de contenu.