ICLRMetaHost::GetRuntime (Método)

Artículo
08/10/2011

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

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

Parámetros

pwzVersion
[in] Versión de compilación de .NET Framework almacenada en los metadatos, en 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, respectivamente.

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

Algunos 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. El prefijo "v" es necesario.

riid
[in] Identificador de 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 se corresponde con el runtime solicitado.

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	El valor de pwzVersion o ppRuntime es NULL.

Comentarios

Este método interactúa de forma coherente con interfaces de legado como la interfaz ICorRuntimeHost y funciones heredadas como las funciones desusadas CorBindTo* (vea Funciones estáticas globales de hospedaje de .NET Framework 1.1 y 2.0 en la API de hospedaje de .NET Framework 2.0). Es decir, los runtimes que se cargan con la API heredada están visibles para la nueva API, y los runtimes que se cargan con la nueva API están visibles para la API heredada. .