ICLRMetaHost (Interfaz)

  • Artículo

Proporciona métodos que devuelven una versión específica de Common Language Runtime (CLR) en función de su número de versión, muestran una lista de todos los CLR instalados, muestran una lista de todos los runtimes que se cargan en un proceso especificado, detectan la versión de CLR usada para compilar un ensamblado, salen de un proceso con un apagado limpio del runtime y consultan el enlace de la API heredada.

Métodos

Método Descripción
Método EnumerateInstalledRuntimes Devuelve una enumeración que contiene un puntero de interfaz ICLRRuntimeInfo válido para cada versión de CLR instalada en un equipo.
Método EnumerateLoadedRuntimes Devuelve una enumeración que contiene un puntero de interfaz ICLRRuntimeInfo válido para cada CLR cargado en un proceso determinado. Este método sustituye a GetVersionFromProcess.
ExitProcess (Método) Intenta apagar todos los runtime cargados correctamente y, después, finaliza el proceso. Reemplaza la función CorExitProcess.
Método GetRuntime Obtiene la interfaz ICLRRuntimeInfo que corresponde a una versión de CLR determinada. Este método sustituye a la función CorBindToRuntimeEx usada con la marca STARTUP_LOADER_SAFEMODE.
Método GetVersionFromFile Obtiene la versión de compilación original de .NET Framework del ensamblado (almacenada en los metadatos), dada su ruta de acceso al archivo. Este método sustituye a GetFileVersion.
Método QueryLegacyV2RuntimeBinding Devuelve una interfaz que representa un runtime al que se ha enlazado la directiva de activación heredada, por ejemplo, mediante 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.
Método RequestRuntimeLoadedNotification Garantiza una devolución de llamada al puntero de función especificado cuando se carga por primera vez una versión de CLR, pero aún no se ha iniciado. Este método sustituye a LockClrVersion.

Comentarios

La única manera de obtener una instancia de esta interfaz es llamar a la función CLRCreateInstance tal como se muestra debajo:

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

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: MetaHost.h

Biblioteca: incluida como recurso en MSCorEE.dll

Versiones de .NET Framework: disponible a partir de la versión 4

Consulte también