Compartir a través de

ICLRRuntimeInfo::GetInterface (Método)

  • Artículo

Carga el CLR en el proceso actual y devuelve punteros de interfaz en tiempo de ejecución, como ICLRRuntimeHost, ICLRStrongName e IMetaDataDispenser.

Este método reemplaza todas las funciones CorBindTo* de la sección Funciones estáticas globales de hospedaje de .NET Framework 1.1 y 2.0.

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

Parámetros

  • rclsid
    [in] Interfaz CLSID para la coclase.

  • riid
    [in] Identificador de la interfaz rclsid solicitada.

  • ppUnk
    [out] Puntero a la interfaz consultada.

Valor devuelto

Este método devuelve los siguientes HRESULT específicos, así como errores HRESULT que indican la existencia de un error en el método.

HRESULT

Descripción

S_OK

El método se ha ejecutado correctamente.

E_POINTER

ppUnk es null.

E_OUTOFMEMORY

No hay suficiente memoria disponible para controlar la solicitud.

CLR_E_SHIM_LEGACYRUNTIMEALREADYBOUND

Un runtime diferente ya se enlazó a la directiva de activación de la versión 2 de CLR heredada.

Comentarios

Este método hace que el CLR se cargue pero no se inicialice.

En la tabla siguiente se muestran las combinaciones admitidas para rclsid y 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

Requisitos

Plataformas: vea Requisitos de sistema de .NET Framework.

Encabezado: MetaHost.h

Biblioteca: Se incluye como recurso en MsCorEE.dll

Versiones de .NET Framework: 4

Vea también

Referencia

ICLRRuntimeInfo (Interfaz)

Otros recursos

Interfaces de hospedaje

Hospedaje (Referencia de la API no administrada)

Historial de cambios

Fecha

Historial

Motivo

Octubre de 2010

Se agregó CLR_E_SHIM_LEGACYRUNTIMEALREADYBOUND a los códigos de devolución.

Corrección de errores de contenido.

Septiembre de 2010

Se corrigieron varias entradas de riid.

Comentarios de los clientes.

Junio de 2010

Se corrigió el objeto riid que se puede utilizar junto con CLSID_CLRRuntimeHost.

Corrección de errores de contenido.