Функция GetRequestedRuntimeInfo

  • Статья

Возвращает сведения о версии и каталоге среды CLR, запрошенной приложением.

Эта функция устарела в платформа .NET Framework 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  
);

Параметры

pExe
[in] Имя приложения.

pwszVersion
[in] Строка, указывающая номер версии среды выполнения.

pConfigurationFile
[in] Имя файла конфигурации, связанного с pExe.

startupFlags
[in] Одно или несколько значений перечисления STARTUP_FLAGS .

runtimeInfoFlags
[in] Одно или несколько значений перечисления RUNTIME_INFO_FLAGS .

pDirectory
[out] Буфер, содержащий путь к каталогу к среде выполнения после успешного завершения.

dwDirectory
[in] Длина буфера каталога.

dwDirectoryLength
[out] Указатель на длину строки пути к каталогу.

pVersion
[out] Буфер, содержащий номер версии среды выполнения после успешного завершения.

cchBuffer
[in] Длина буфера строки версии.

dwlength
[out] Указатель на длину строки версии.

Возвращаемое значение

Этот метод возвращает стандартные коды ошибок COM, как определено в WinError.h, в дополнение к следующим значениям.

Код возврата Описание
S_OK Метод завершился успешно.
ERROR_INSUFFICIENT_BUFFER Буфер каталога недостаточно велик для хранения пути к каталогу.

— или —

Буфер версий недостаточно велик для хранения строки версии.

Комментарии

Метод GetRequestedRuntimeInfo возвращает сведения во время выполнения о версии, загруженной в процесс, которая не обязательно является последней версией, установленной на компьютере.

В платформа .NET Framework версии 2.0 можно получить сведения о последней установленной версии с помощью GetRequestedRuntimeInfo метода следующим образом:

  • pExeУкажите для параметров , pwszVersionи pConfigurationFile значение NULL.

  • Укажите флаг RUNTIME_INFO_UPGRADE_VERSION в перечислениях RUNTIME_INFO_FLAGSruntimeInfoFlags параметра .

Метод GetRequestedRuntimeInfo не возвращает последнюю версию СРЕДЫ CLR в следующих случаях:

  • Существует файл конфигурации приложения, указывающий загрузку определенной версии среды CLR. Обратите внимание, что платформа .NET Framework будет использовать файл конфигурации, даже если для pConfigurationFile параметра задано значение NULL.

  • Метод CorBindToRuntimeEx был вызван с указанием более ранней версии СРЕДЫ CLR.

  • Приложение, скомпилированное для более ранней версии СРЕДЫ CLR, в настоящее время выполняется.

runtimeInfoFlags Для параметра можно указать только одну из констант архитектуры перечисления RUNTIME_INFO_FLAGS за раз:

  • RUNTIME_INFO_REQUEST_IA64

  • RUNTIME_INFO_REQUEST_AMD64

  • RUNTIME_INFO_REQUEST_X86

Требования

Платформы: см. раздел Требования к системе.

Заголовка: MSCorEE.h

Библиотека: MSCorEE.dll

платформа .NET Framework версии: доступно с версии 1.1

См. также раздел