GetRequestedRuntimeInfo (Función)
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
ypConfigurationFile
como NULL.Especifique la marca RUNTIME_INFO_UPGRADE_VERSION en las enumeraciones
RUNTIME_INFO_FLAGS
del parámetroruntimeInfoFlags
.
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