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


Функция RtlGetVersion (wdm.h)

Подпрограмма RtlGetVersion возвращает сведения о версии текущей операционной системы.

Синтаксис

NTSYSAPI NTSTATUS RtlGetVersion(
  [out] PRTL_OSVERSIONINFOW lpVersionInformation
);

Параметры

[out] lpVersionInformation

Указатель на структуру RTL_OSVERSIONINFOW или RTL_OSVERSIONINFOEXW структуру, содержащую сведения о версии текущей операционной системы. Вызывающий объект указывает, какая структура входных данных используется, задав члену dwOSVersionInfoSize структуры размер используемой структуры в байтах.

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

RtlGetVersion возвращает STATUS_SUCCESS.

Комментарии

RtlGetVersion — это эквивалент функции GetVersionEx в пользовательском режиме в windows SDK. См. пример в Пакете SDK для Windows, где показано, как получить версию системы.

При использовании RtlGetVersion для определения того, запущена ли определенная версия операционной системы, вызывающий объект должен проверка для номеров версий, которые больше или равны требуемому номеру версии. Это гарантирует успешное тестирование версии для более поздних версий Windows.

Так как компоненты операционной системы можно добавить в распространяемую библиотеку DLL, проверка только основных и дополнительных номеров версий не является самым надежным способом проверки наличия конкретного системного компонента. Драйвер должен использовать RtlVerifyVersionInfo для проверки наличия определенного системного компонента.

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows 2000.
Целевая платформа Универсальное
Верхняя часть wdm.h (включая Ntddk.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

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

PsGetVersion