Metodo ICLRRuntimeInfo::GetInterfaceICLRRuntimeInfo::GetInterface Method

Carica CLR nel processo corrente e restituisce runtime puntatori di interfaccia, ad esempio ICLRRuntimeHost, ICLRStrongName, e IMetaDataDispenserEx.Loads the CLR into the current process and returns runtime interface pointers, such as ICLRRuntimeHost, ICLRStrongName, and IMetaDataDispenserEx.

Questo metodo sostituisce tutte le CorBindTo* delle funzioni di funzioni di Hosting CLR deprecate sezione.This method supersedes all the CorBindTo* functions in the Deprecated CLR Hosting Functions section.

SintassiSyntax

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

ParametriParameters

rclsid
[in] L'interfaccia CLSID per la coclasse.[in] The CLSID interface for the coclass.

riid
[in] L'IID richiesti rclsid interfaccia.[in] The IID of the requested rclsid interface.

ppUnk
[out] Un puntatore all'interfaccia di query.[out] A pointer to the queried interface.

Valore restituitoReturn Value

Questo metodo restituisce gli specifici HRESULT seguenti, nonché gli errori di HRESULT che indicano la mancata riuscita del metodo.This method returns the following specific HRESULTs as well as HRESULT errors that indicate method failure.

HRESULTHRESULT DescrizioneDescription
S_OKS_OK Metodo completato correttamente.The method completed successfully.
E_POINTERE_POINTER ppUnk è null.ppUnk is null.
E_OUTOFMEMORYE_OUTOFMEMORY Memoria insufficiente è disponibile per gestire la richiesta.Not enough memory is available to handle the request.
CLR_E_SHIM_LEGACYRUNTIMEALREADYBOUNDCLR_E_SHIM_LEGACYRUNTIMEALREADYBOUND Un runtime diverso è già associato ai criteri di attivazione 2 versione CLR legacy.A different runtime was already bound to the legacy CLR version 2 activation policy.

NoteRemarks

Questo metodo, CLR essere caricato, ma non inizializzato.This method causes the CLR to be loaded but not initialized.

La tabella seguente mostra le combinazioni supportate per rclsid e riid.The following table shows the supported combinations for rclsid and riid.

rclsid riid
CLSID_CorMetaDataDispenserCLSID_CorMetaDataDispenser IID_IMetaDataDispenser, IID_IMetaDataDispenserExIID_IMetaDataDispenser, IID_IMetaDataDispenserEx
CLSID_CorMetaDataDispenserRuntimeCLSID_CorMetaDataDispenserRuntime IID_IMetaDataDispenser, IID_IMetaDataDispenserExIID_IMetaDataDispenser, IID_IMetaDataDispenserEx
CLSID_CorRuntimeHostCLSID_CorRuntimeHost IID_ICorRuntimeHostIID_ICorRuntimeHost
CLSID_CLRRuntimeHostCLSID_CLRRuntimeHost IID_ICLRRuntimeHostIID_ICLRRuntimeHost
CLSID_TypeNameFactoryCLSID_TypeNameFactory IID_ITypeNameFactoryIID_ITypeNameFactory
CLSID_CLRDebuggingLegacyCLSID_CLRDebuggingLegacy IID_ICorDebugIID_ICorDebug
CLSID_CLRStrongNameCLSID_CLRStrongName IID_ICLRStrongNameIID_ICLRStrongName

RequisitiRequirements

Piattaforme: vedere requisiti di sistema.Platforms: See System Requirements.

Intestazione: Metahost. HHeader: MetaHost.h

Libreria: inclusa come risorsa in Mscoree. dllLibrary: Included as a resource in MSCorEE.dll

Versioni di .NET framework: Disponibile dalla 4Available since 4.NET Framework Versions: Disponibile dalla 4Available since 4

Vedere ancheSee Also

Interfaccia ICLRRuntimeInfoICLRRuntimeInfo Interface
Interfacce di hostingHosting Interfaces
HostingHosting