VerSetConditionMask-Funktion (winnt.h)

  • Artikel

Legt die Bits eines 64-Bit-Werts fest, um den Vergleichsoperator anzugeben, der für ein angegebenes Betriebssystemversionsattribut verwendet werden soll. Diese Funktion wird verwendet, um den dwlConditionMask-Parameter der VerifyVersionInfo-Funktion zu erstellen.

Syntax

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

Parameter

[in] ConditionMask

Ein Wert, der als dwlConditionMask-Parameter der VerifyVersionInfo-Funktion übergeben werden soll. Die Funktion speichert die Vergleichsinformationen in den Bits dieser Variablen.

Initialisieren Sie diese Variable vor dem ersten Aufruf von VerSetCondition auf Null. Übergeben Sie für nachfolgende Aufrufe die Variable, die im vorherigen Aufruf verwendet wurde.

[in] TypeMask

Eine Maske, die den Member der OSVERSIONINFOEX-Struktur angibt, dessen Vergleichsoperator festgelegt wird. Dieser Wert entspricht einem der Bits, die im dwTypeMask-Parameter für die VerifyVersionInfo-Funktion angegeben sind. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert Bedeutung
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

Der für den Vergleich zu verwendende Operator. Die VerifyVersionInfo-Funktion verwendet diesen Operator, um einen angegebenen Attributwert mit dem entsprechenden Wert für das derzeit ausgeführte System zu vergleichen.

Für alle Werte von dwTypeBitMask außer VER_SUITENAME kann dieser Parameter einer der folgenden Werte sein.

Wert Bedeutung
VER_EQUAL
1
 Der aktuelle Wert muss dem angegebenen Wert entsprechen.
VER_GREATER
2
 Der aktuelle Wert muss größer als der angegebene Wert sein.
VER_GREATER_EQUAL
3
 Der aktuelle Wert muss größer oder gleich dem angegebenen Wert sein.
VER_LESS
4
 Der aktuelle Wert muss kleiner als der angegebene Wert sein.
VER_LESS_EQUAL
5
 Der aktuelle Wert muss kleiner oder gleich dem angegebenen Wert sein.
 

Wenn dwTypeBitMask VER_SUITENAME ist, kann dieser Parameter einer der folgenden Werte sein.

Wert Bedeutung
VER_AND
6
 Alle im wSuiteMask-Member angegebenen Produktsammlungen müssen im aktuellen System vorhanden sein.
VER_OR
7
 Mindestens eine der angegebenen Produktsammlungen muss im aktuellen System vorhanden sein.

Rückgabewert

Die Funktion gibt den Wert der Bedingungsmaske zurück.

Hinweise

Rufen Sie diese Funktion einmal für jedes Bit auf, das im dwTypeMask-Parameter der VerifyVersionInfo-Funktion festgelegt ist.

Beispiele

Ein Beispiel finden Sie unter Überprüfen der Systemversion.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winnt.h (windows.h einschließen)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

OSVERSIONINFOEX

Betriebssystemversion

Systeminformationsfunktionen

VerifyVersionInfo