Compartir a través de

Función GetRequestedRuntimeInfo

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

Esta función ha quedado en desuso en .NET Framework 4.

Syntax

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 tiempo 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 de STARTUP_FLAGS .

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

pDirectory [out] Búfer que contiene la ruta de acceso del directorio al tiempo 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 tiempo de ejecución tras la finalización correcta.

cchBuffer [in] Longitud del búfer de 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 componentes (COM), tal como se define en WinError.h, además de los siguientes valores.

Código de retorno Description
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 -

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

Observaciones

El GetRequestedRuntimeInfo método devuelve información en tiempo 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 GetRequestedRuntimeInfo método siguiente:

  • Especifique los pExeparámetros , pwszVersiony pConfigurationFile como null.

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

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

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

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

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

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

  • RUNTIME_INFO_REQUEST_IA64

  • RUNTIME_INFO_REQUEST_AMD64

  • RUNTIME_INFO_REQUEST_X86

Requisitos

Plataformas: Consulte Requisitos del sistema.

Encabezado: MSCorEE.h

Biblioteca: MSCorEE.dll

Versiones de .NET Framework: Disponible desde la versión 1.1

Consulte también

  • Last updated on