ICLRMetaHost::GetRuntime (Método)

  • Artículo

Obtiene la interfaz ICLRRuntimeInfo que corresponde a una versión determinada de Common Language Runtime (CLR). Este método sustituye a la función CorBindToRuntimeEx usada con la marca STARTUP_LOADER_SAFEMODE.

Sintaxis

HRESULT GetRuntime (  
    [in] LPCWSTR pwzVersion,  
    [in] REFIID riid,  
    [out,iid_is(riid), retval] LPVOID *ppRuntime  
);

Parámetros

pwzVersion
[in] La versión de compilación de .NET Framework almacenada en los metadatos, con el formato "vA.B[.X]". A, B y X son números decimales que corresponden a la versión principal, la versión secundaria y el número de compilación.

Nota

Este parámetro debe coincidir con el nombre de directorio de la versión de .NET Framework, como aparece en C:\Windows\Microsoft.NET\Framework o C:\Windows\Microsoft.NET\Framework64.

Los valores de ejemplo son "v1.0.3705", "v1.1.4322", "v2.0.50727" y "v4.0.X", donde X depende del número de compilación instalado. Se requiere el prefijo "v".

riid
[in] El identificador para la interfaz deseada. Actualmente el único valor válido para este parámetro es IID_ICLRRuntimeInfo.

ppRuntime
[out] Un puntero a la interfaz ICLRRuntimeInfo que corresponde al runtime solicitado.

Valor devuelto

Este método devuelve los siguientes HRESULT específicos y los errores HRESULT que indican un error del método.

HRESULT Descripción
S_OK El método se completó correctamente.
E_POINTER pwzVersion o ppRuntime es null.

Comentarios

Este método interactúa de forma coherente con interfaces heredadas, como la interfaz ICorRuntimeHost, y funciones heredadas, como las funciones en desuso CorBindTo* (consulte Funciones de hospedaje CLR en desuso en la API de hospedaje de .NET Framework 2.0). Es decir, los runtimes que se cargan con la API heredada son visibles para la nueva API y los runtimes que se cargan con la nueva API son visibles para la API heredada.

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