Condividi tramite


Metodo ICLRRuntimeInfo::GetInterface

Carica CLR nel processo corrente e restituisce puntatori a interfaccia di runtime, ad esempio ICLRRuntimeHost, ICLRStrongName e IMetaDataDispenser.

Questo metodo sostituisce tutte le funzioni CorBindTo* nella sezione Funzioni statiche globali di hosting di .NET Framework 1.1 e 2.0.

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

Parametri

  • rclsid
    [in] Interfaccia CLSID della coclasse.

  • riid
    [in] IID dell'interfaccia rclsid richiesta.

  • ppUnk
    [out] Puntatore all'interfaccia per cui è stata eseguita la query.

Valore restituito

Questo metodo restituisce gli HRESULT specifici seguenti nonché gli errori HRESULT che indicano l'esito negativo del metodo.

HRESULT

Oggetto di descrizione

S_OK

Il metodo è stato eseguito correttamente.

E_POINTER

ppUnk è null.

E_OUTOFMEMORY

La memoria disponibile è insufficiente per gestire la richiesta.

CLR_E_SHIM_LEGACYRUNTIMEALREADYBOUND

Un runtime diverso è stato già associato ai criteri di attivazione della versione CLR legacy 2.

Note

Questo metodo comporta il caricamento ma non l'inizializzazione del runtime.

Nella tabella seguente sono mostrate le combinazioni supportate per rclsid e 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

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MetaHost.h

Libreria: inclusa come risorsa in MSCorEE.dll

Versioni di .NET Framework: 4

Vedere anche

Riferimenti

Interfaccia ICLRRuntimeInfo

Altre risorse

Interfacce di hosting

Hosting (riferimenti alle API non gestite)

Cronologia delle modifiche

Data

Cronologia

Motivo

Ottobre 2010

È stato aggiunto CLR_E_SHIM_LEGACYRUNTIMEALREADYBOUND ai codici restituiti.

Correzione di bug nel contenuto.

Settembre 2010

Sono state corrette diverse voci riid.

Commenti e suggerimenti dei clienti.

Giugno 2010

È stato corretto il riid che può essere utilizzato in combinazione con CLSID_CLRRuntimeHost.

Correzione di bug nel contenuto.