ICLRMetaHost (Interfaz)

Artículo
08/10/2011

Proporciona métodos que devuelven una versión concreta del Common Language Runtime (CLR) basándose en su número de versión, muestra todos los CLR instalados y todos los runtime que están cargados en un determinado proceso, detecta la versión de CLR usada para compilar un ensamblado, sale de un proceso con el apagado de runtime limpio y consulta el enlace de API heredado.

Métodos

Método	Descripción
ICLRMetaHost::EnumerateInstalledRuntimes (Método)	Devuelve una enumeración que contiene y devuelve un puntero de interfaz ICLRRuntimeInfo válido para cada versión de CLR instalada en un equipo.
ICLRMetaHost::EnumerateLoadedRuntimes (Método)	Devuelve una enumeración que contiene un puntero de interfaz ICLRRuntimeInfo válido para cada CLR que se carga en un proceso determinado. Este método reemplaza GetVersionFromProcess.
ICLRMetaHost::ExitProcess (Método)	Intenta cerrar todos los runtime cargados correctamente y a continuación finaliza el proceso. Reemplaza la función CorExitProcess.
ICLRMetaHost::GetRuntime (Método)	Obtiene la interfaz ICLRRuntimeInfo que se corresponde con una versión de CLR determinada. Este método reemplaza la función CorBindToRuntimeEx usada con la marca STARTUP_LOADER_SAFEMODE.
ICLRMetaHost::GetVersionFromFile (Método)	Obtiene la versión de compilación original de .NET Framework del ensamblado (almacenada en los metadatos), dada su ruta de acceso del archivo. Este método reemplaza GetFileVersion.
ICLRMetaHost::QueryLegacyV2RuntimeBinding (Método)	Devuelve una interfaz que representa un runtime al que se ha enlazado la directiva de activación heredada, por ejemplo, utilizando el atributo useLegacyV2RuntimeActivationPolicy en la entrada del archivo de configuración Elemento <startup>, por uso directo de las API de activación heredadas o llamando al método ICLRRuntimeInfo::BindAsLegacyV2Runtime.
ICLRMetaHost::RequestRuntimeLoadedNotification (Método)	Garantiza una devolución de llamada para el puntero a función especificado cuando una versión CLR se carga por primera vez, pero todavía no se ha iniciado. Este método reemplaza LockClrVersion

Comentarios

La única manera de obtener una instancia de esta interfaz es llamando a la función CLRCreateInstance de la manera siguiente:

ICLRMetaHost *pMetaHost = NULL;
HRESULT hr = CLRCreateInstance(CLSID_CLRMetaHost,
                   IID_ICLRMetaHost, (LPVOID*)&pMetaHost);

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

Otros recursos

Interfaces de hospedaje

Hospedaje (Referencia de la API no administrada)

Historial de cambios

Fecha	Historial	Motivo
Septiembre de 2010	IID corregido en la lista de código.	Comentarios de los clientes.

Septiembre de 2010

IID corregido en la lista de código.

Comentarios de los clientes.

Share via