GetRequestedRuntimeInfo (Función)

  • Artículo

Obtiene información de versión y directorio sobre Common Language Runtime (CLR) solicitada por una aplicación.

Esta función está en desuso en .NET Framework 4.

Sintaxis

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] El nombre de la aplicación.

pwszVersion
[in] Cadena que especifica el número de versión del entorno de ejecución.

pConfigurationFile
[in] Nombre del archivo de configuración asociado a pExe.

startupFlags
[in] Uno o varios de los valores de enumeración STARTUP_FLAGS.

runtimeInfoFlags
[in] Uno o varios de los valores de enumeración RUNTIME_INFO_FLAGS.

pDirectory
[out] Búfer que contiene la ruta de acceso del directorio al entorno de ejecución tras la finalización correcta.

dwDirectory
[in] Longitud del búfer del directorio.

dwDirectoryLength
[out] Puntero a la longitud de la cadena de ruta de acceso del directorio.

pVersion
[out] Búfer que contiene el número de versión del entorno de ejecución tras la finalización correcta.

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 códigos de error estándar del Modelo de objetos de componentes (COM), tal como se define en WinError.h, además de los valores siguientes.

Código devuelto Descripción
S_OK El método se completó correctamente.
ERROR_INSUFFICIENT_BUFFER El búfer de directorios no es lo suficientemente grande como para almacenar la ruta de acceso del 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 del entorno de ejecución sobre la versión cargada en el proceso, que no es necesariamente la versión más reciente instalada en el equipo.

En .NET Framework, versión 2.0, puede obtener información sobre la versión instalada más reciente mediante el método GetRequestedRuntimeInfo del modo siguiente:

  • Especifique los parámetros pExe, pwszVersion y pConfigurationFile como NULL.

  • Especifique la marca RUNTIME_INFO_UPGRADE_VERSION en las enumeraciones RUNTIME_INFO_FLAGS del parámetro runtimeInfoFlags.

El método GetRequestedRuntimeInfo no devuelve la versión más reciente de CLR en las siguientes circunstancias:

  • Existe un archivo de configuración de la aplicación que especifica la carga de una versión CLR determinada. Tenga en cuenta que .NET Framework usará el archivo de configuración incluso si especifica null para el parámetro pConfigurationFile.

  • Se llamó al método CorBindToRuntimeEx especificando una versión anterior de CLR.

  • Actualmente se está ejecutando una aplicación compilada para una versión anterior de CLR.

Para el parámetro runtimeInfoFlags, solo puede especificar una de las constantes de arquitectura de la enumeración RUNTIME_INFO_FLAGS a la vez:

  • RUNTIME_INFO_REQUEST_IA64

  • RUNTIME_INFO_REQUEST_AMD64

  • RUNTIME_INFO_REQUEST_X86

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: MSCorEE.h

Biblioteca: MSCorEE.dll

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

Consulte también