verSetConditionMask 函数 (winnt.h)

  • 项目

设置 64 位值的位，以指示要用于指定操作系统版本属性的比较运算符。 此函数用于生成 VerifyVersionInfo 函数的 dwlConditionMask 参数。

语法

NTSYSAPI ULONGLONG VerSetConditionMask(
  [in] ULONGLONG ConditionMask,
  [in] DWORD     TypeMask,
  [in] BYTE      Condition
);

参数

[in] ConditionMask

要作为 VerifyVersionInfo 函数的 dwlConditionMask 参数传递的值。 函数将比较信息存储在此变量的位中。

在第一次调用 VerSetCondition 之前，将此变量初始化为零。 对于后续调用，传入上一次调用中使用的 变量。

[in] TypeMask

一个掩码，指示要设置其比较运算符的 OSVERSIONINFOEX 结构的成员。 此值对应于在 VerifyVersionInfo 函数的 dwTypeMask 参数中指定的位之一。 此参数的取值可为下列值之一：

值 含义
VER_BUILDNUMBER
0x0000004
 dwBuildNumber
VER_MAJORVERSION
0x0000002
 dwMajorVersion
VER_MINORVERSION
0x0000001
 dwMinorVersion
VER_PLATFORMID
0x0000008
 dwPlatformId
VER_PRODUCT_TYPE
0x0000080
 wProductType
VER_SERVICEPACKMAJOR
0x0000020
 wServicePackMajor
VER_SERVICEPACKMINOR
0x0000010
 wServicePackMinor
VER_SUITENAME
0x0000040
 wSuiteMask

[in] Condition

要用于比较的运算符。 VerifyVersionInfo 函数使用此运算符将指定的属性值与当前正在运行的系统对应的值进行比较。

对于除 VER_SUITENAME 以外的所有 dwTypeBitMask 值，此参数可以是以下值之一。

值 含义
VER_EQUAL
1
 当前值必须等于指定的值。
VER_GREATER
2
 当前值必须大于指定的值。
VER_GREATER_EQUAL
3
 当前值必须大于或等于指定的值。
VER_LESS
4
 当前值必须小于指定的值。
VER_LESS_EQUAL
5
 当前值必须小于或等于指定的值。
 

如果 dwTypeBitMask VER_SUITENAME，则此参数可以是以下值之一。

值 含义
VER_AND
6
 在 wSuiteMask 成员中指定的所有产品套件都必须存在于当前系统中。
VER_OR
7
 当前系统中必须至少有一个指定的产品套件。

返回值

函数返回条件掩码值。

注解

对 VerifyVersionInfo 函数的 dwTypeMask 参数中设置的每个位调用此函数一次。

示例

有关示例，请参阅 验证系统版本。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winnt.h (包括 Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

OSVERSIONINFOEX

操作系统版本

系统信息函数

VerifyVersionInfo