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

Статья
03/08/2023

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

Синтаксис

NTSYSAPI NTSTATUS RtlVerifyVersionInfo(
  [in] PRTL_OSVERSIONINFOEXW VersionInfo,
  [in] ULONG                 TypeMask,
  [in] ULONGLONG             ConditionMask
);

Параметры

[in] VersionInfo

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

[in] TypeMask

Указывает, какие элементы VersionInfo сравнивать с соответствующими атрибутами текущей версии операционной системы. TypeMask имеет логическое или одно или несколько из следующих значений.

Значение	Соответствующий элемент
VER_BUILDNUMBER	dwBuildNumber
VER_MAJORVERSION	dwMajorVersion
VER_MINORVERSION	dwMinorVersion
VER_PLATFORMID	dwPlatformId
VER_SERVICEPACKMAJOR	wServicePackMajor
VER_SERVICEPACKMINOR	wServicePackMinor
VER_SUITENAME	wSuiteMask
VER_PRODUCT_TYPE	wProductType

[in] ConditionMask

Указывает способ сравнения каждого элемента VersionInfo . Чтобы задать значение ConditionMask, вызывающий объект должен использовать макрос VER_SET_CONDITION :

VER_SET_CONDITION (
        IN OUT  ULONGLONG  ConditionMask,
        IN ULONG  TypeBitMask,
        IN UCHAR  ComparisonType
        );

Значение ConditionMask создается следующим образом:

Инициализируйте значение ConditionMask равным нулю.
Вызовите VER_SET_CONDITION один раз для каждого члена VersionInfo, указанного в TypeMask.
Задайте параметры TypeBitMask и ComparisonType для каждого вызова VER_SET_CONDITION следующим образом:

TypeBitMask

Указывает элемент VersionInfo , для которого задан тип сравнения. TypeBitMask может иметь одно из следующих значений.

Значение	Соответствующий элемент
VER_BUILDNUMBER	dwBuildNumber
VER_MAJORVERSION	dwMajorVersion
VER_MINORVERSION	dwMinorVersion
VER_PLATFORMID	dwPlatformId
VER_SERVICEPACKMAJOR	wServicePackMajor
VER_SERVICEPACKMINOR	wServicePackMinor
VER_SUITENAME	wSuiteMask
VER_PRODUCT_TYPE	wProductType

ComparisonType

Указывает тип сравнения, используемый RtlVerifyVersionInfo для сравнения элемента VersionInfo , указанного в TypeBitMask , с соответствующим атрибутом текущей операционной системы.

Для всех значений TypeBitMask , отличных от VER_SUITENAME, параметру ComparisonType присваивается одно из следующих значений.

Значение	Значение
VER_EQUAL	Текущее значение должно быть равно указанному значению.
VER_GREATER	Текущее значение должно быть больше указанного значения.
VER_GREATER_EQUAL	Текущее значение должно быть больше или равно указанному значению.
VER_LESS	Текущее значение должно быть меньше указанного значения.
VER_LESS_EQUAL	Текущее значение должно быть меньше или равно указанному значению.

Если для TypeBitMask задано значение VER_SUITENAME, параметру ComparisonType присваивается одно из следующих значений.

Значение	Значение
VER_AND	Все наборы продуктов, указанные в элементе wSuiteMask , должны присутствовать в текущей системе.
VER_OR	В текущей системе должен присутствовать по крайней мере один из указанных наборов продуктов.

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

RtlVerifyVersionInfo возвращает одно из следующих значений состояния:

Код возврата	Описание
STATUS_SUCCESS	Указанная версия соответствует текущей версии операционной системы.
STATUS_INVALID_PARAMETER	Входные параметры недопустимы.
STATUS_REVISION_MISMATCH	Указанная версия не соответствует текущей версии операционной системы.

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

Как правило, RtlVerifyVersionInfo возвращает STATUS_SUCCESS только в случае успешного выполнения всех сравнений. Однако основная, дополнительная версия и версия пакета обновления проверяются последовательно следующим образом:

Если основная версия превышает минимальное требуемое значение, то дополнительная версия и версия пакета обновления не проверяются. Например, если текущая основная версия — 6.0, проверка системы, более или равной версии 5.1 с пакетом обновления 1 (SP1) будет выполнена успешно. Дополнительная версия и версия пакета обновления не проверяются.
Если дополнительный номер версии превышает минимальную требуемую версию, версия пакета обновления не проверяется. Например, если текущая основная версия — 5.2, проверка версии системы больше или равна версии 5.1 с пакетом обновления 1 (SP1) будет успешно выполнена. Версия пакета обновления не проверяется.
Если основная версия пакета обновления превышает минимальную требуемую версию, дополнительная версия пакета обновления не проверяется.

Чтобы проверить диапазон версий системы, драйвер может вызвать RtlVerifyVersionInfo дважды: один раз для проверки нижней границы в системной версии и один раз для проверки верхней границы в системной версии.

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	wdm.h (включая Ntddk.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe (режим ядра); Ntdll.dll (пользовательский режим)
IRQL	PASSIVE_LEVEL