VerSetConditionMask-Funktion (winnt.h)

Artikel
03/13/2024

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

Freigeben über