Поделиться через

Функция GetRequestedRuntimeInfo

  • Статья

Обновлен: Ноябрь 2007

Получает запрашиваемые приложением сведения о версии и каталоге среды CLR.

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_FLAGS для параметра runtimeInfoFlags.

Метод 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

Требования

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

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

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

Версии платформы .NET Framework: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0, 1.1

См. также

Задачи

Пример CLR Version Detection Technology

Ссылки

Функция GetRequestedRuntimeVersion

Функция GetVersionFromProcess

Другие ресурсы

Функции Hosting Global Static