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

Функция 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, помимо следующих значений.

Код возврата Description
S_OK Метод успешно завершен.
ERROR_INSUFFICIENT_BUFFER Буфер каталога недостаточно велик, чтобы сохранить путь к каталогу.

-или-

Буфер версии недостаточно велик, чтобы сохранить строку версии.

Замечания

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

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

  • pExeУкажите значение null pwszVersionи pConfigurationFile параметры.

  • Укажите флаг 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

Требования

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

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

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

Версии .NET Framework: Доступно с версии 1.1

См. также

  • Last updated on