ICLRMetaHost::GetRuntime (Método)
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