GetRequestedRuntimeInfo (Función)

Artículo
08/10/2011

Obtiene la información de versión y de directorio del motor de Common Language Runtime (CLR) que una aplicación ha solicitado.

Esta función está desusada en .NET Framework versión 4.

HRESULT GetRequestedRuntimeInfo (
    [in]  LPCWSTR  pExe, 
    [in]  LPCWSTR  pwszVersion, 
    [in]  LPCWSTR  pConfigurationFile, 
    [in]  DWORD    startupFlags, 
    [in]  DWORD    runtimeInfoFlags, 
    [out] LPWSTR   pDirectory, 
    [in]  DWORD    dwDirectory, 
    [out] DWORD   *dwDirectoryLength, 
    [out] LPWSTR   pVersion, 
    [in]  DWORD    cchBuffer, 
    [out] DWORD   *dwlength
);

Parámetros

pExe
[in] Nombre de la aplicación.
pwszVersion
[in] Cadena que especifica el número de versión del motor en tiempo de ejecución.
pConfigurationFile
[in] Nombre del archivo de configuración asociado a pExe.
startupFlags
[in] Uno o varios valores de la enumeración STARTUP_FLAGS.
runtimeInfoFlags
[in] Uno o varios valores de la enumeración RUNTIME_INFO_FLAGS.
pDirectory
[out] Búfer que contiene la ruta de acceso al directorio del motor en tiempo de ejecución cuando se ha ejecutado correctamente.
dwDirectory
[in] Longitud del búfer de directorio.
dwDirectoryLength
[out] Puntero a la longitud de la cadena de la ruta de acceso al directorio.
pVersion
[out] Búfer que contiene el número de versión del motor en tiempo de ejecución cuando se ha ejecutado correctamente.
cchBuffer
[in] Longitud del búfer de la cadena de versión.
dwlength
[out] Puntero a la longitud de la cadena de versión.

Valor devuelto

Este método devuelve los códigos de error estándar del Modelo de objetos componentes (COM), tal como se encuentran definidos en WinError.h, además de los valores siguientes.

Código devuelto	Descripción
S_OK	El método se ha ejecutado correctamente.
ERROR_INSUFFICIENT_BUFFER	El búfer de directorio no es lo suficientemente grande como para almacenar la ruta de acceso al directorio. ‑O bien- El búfer de versión no es lo suficientemente grande como para almacenar la cadena de versión.

S_OK

El método se ha ejecutado correctamente.

ERROR_INSUFFICIENT_BUFFER

El búfer de directorio no es lo suficientemente grande como para almacenar la ruta de acceso al directorio.

‑O bien-

El búfer de versión no es lo suficientemente grande como para almacenar la cadena de versión.

Comentarios

El método GetRequestedRuntimeInfo devuelve información acerca de la versión del motor en tiempo de ejecución cargada en el proceso, que no es necesariamente la última versión instalada en el equipo.

En la versión 2.0 de .NET Framework, se puede obtener información acerca de la última versión instalada a través del método GetRequestedRuntimeInfo, de la manera siguiente:

Especifique los parámetros pExe, pwszVersion y pConfigurationFile como NULL.
Especifique el marcador RUNTIME_INFO_UPGRADE_VERSION en las enumeraciones RUNTIME_INFO_FLAGS para el parámetro runtimeInfoFlags.

El método GetRequestedRuntimeInfo no devuelve la última versión de CLR en las circunstancias siguientes:

Archivo de configuración de aplicación que especifica que debe cargarse una versión específica de CLR. Observe que .NET Framework utilizará el archivo de configuración aunque se especifique NULL para el parámetro pConfigurationFile.
Se llamó al método CorBindToRuntimeEx especificando una versión anterior de CLR.
Aplicación que se ha compilado para una versión de CLR anterior a la que se está ejecutando.

Para el parámetro runtimeInfoFlags, sólo se puede especificar una constante de arquitectura de la enumeración RUNTIME_INFO_FLAGS a la vez: