VerSetConditionMask function

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


ULONGLONG WINAPI VerSetConditionMask(
  _In_  ULONGLONG dwlConditionMask,
  _In_  DWORD dwTypeBitMask,
  _In_  BYTE dwConditionMask
);

Parameters

dwlConditionMask [in]

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.

dwTypeBitMask [in]

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.

ValueMeaning
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

 

dwConditionMask [in]

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.

ValueMeaning
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.

ValueMeaning
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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winnt.h (include Windows.h)

Library

Kernel32.lib

DLL

Kernel32.dll

See also

Operating System Version
OSVERSIONINFOEX
System Information Functions
VerifyVersionInfo

 

 

Community Additions

ADD
Show:
© 2014 Microsoft