VerSetConditionMask function (winnt.h)

Article
10/13/2021

Sets the bits of a 64-bit value to indicate the comparison operator to use for a specified operating system version attribute. This function is used to build the dwlConditionMask parameter of the VerifyVersionInfo function.

Syntax

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

Parameters

[in] ConditionMask

A value to be passed as the dwlConditionMask parameter of the VerifyVersionInfo function. The function stores the comparison information in the bits of this variable.

Before the first call to VerSetCondition, initialize this variable to zero. For subsequent calls, pass in the variable used in the previous call.

[in] TypeMask

A mask that indicates the member of the OSVERSIONINFOEX structure whose comparison operator is being set. This value corresponds to one of the bits specified in the dwTypeMask parameter for the VerifyVersionInfo function. This parameter can be one of the following values.

Value	Meaning
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

The operator to be used for the comparison. The VerifyVersionInfo function uses this operator to compare a specified attribute value to the corresponding value for the currently running system.

For all values of dwTypeBitMask other than VER_SUITENAME, this parameter can be one of the following values.

Value	Meaning
VER_EQUAL 1	The current value must be equal to the specified value.
VER_GREATER 2	The current value must be greater than the specified value.
VER_GREATER_EQUAL 3	The current value must be greater than or equal to the specified value.
VER_LESS 4	The current value must be less than the specified value.
VER_LESS_EQUAL 5	The current value must be less than or equal to the specified value.

If dwTypeBitMask is VER_SUITENAME, this parameter can be one of the following values.

Value	Meaning
VER_AND 6	All product suites specified in the wSuiteMask member must be present in the current system.
VER_OR 7	At least one of the specified product suites must be present in the current system.

Return value

The function returns the condition mask value.

Remarks

Call this function once for each bit set in the dwTypeMask parameter of the VerifyVersionInfo function.

Examples

For an example, see Verifying the System Version.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	winnt.h (include Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll