Freigeben über


Versionshilfsfunktionen

Die folgenden Funktionen können verwendet werden, um die aktuelle Betriebssystemversion zu ermitteln oder zu ermitteln, ob es sich um eine Windows- oder Windows Server-Version handelt. Diese Funktionen stellen einfache Tests bereit, die die VerifyVersionInfo--Funktion und die empfohlenen Vergleiche verwenden, die als robuste Mittel zur Ermittlung der Betriebssystemversion nachgewiesen werden.

Anmerkung

Diese APIs werden durch versionhelpers.hdefiniert, das im Windows Software Development Kit (SDK) für Windows 8.1 und höher enthalten ist. Diese Datei kann mit anderen Microsoft Visual Studio-Versionen verwendet werden, um die gleiche Funktionalität für Windows-Versionen vor Windows 8.1 zu implementieren.

Anmerkung

Versionhelpers.h erfordert, dass windows.h eingeschlossen werden muss.

Funktion Beschreibung
IsWindowsXPOrGreater Gibt an, ob die aktuelle Betriebssystemversion mit der Windows XP-Version übereinstimmt oder größer als ist.
IsWindowsXPSP1OrGreater Gibt an, ob die aktuelle Betriebssystemversion übereinstimmt oder größer als ist, die Windows XP mit Service Pack 1 (SP1)-Version.
IsWindowsXPSP2OrGreater Gibt an, ob die aktuelle Betriebssystemversion übereinstimmt oder größer als ist, die Windows XP mit Service Pack 2 (SP2)-Version.
IsWindowsXPSP3OrGreater Gibt an, ob die aktuelle Betriebssystemversion übereinstimmt oder größer als ist, die Windows XP mit Service Pack 3 (SP3)-Version.
IsWindowsVistaOrGreater Gibt an, ob die aktuelle Betriebssystemversion mit der Windows Vista-Version übereinstimmt oder größer als ist.
IsWindowsVistaSP1OrGreater Gibt an, ob die aktuelle Betriebssystemversion übereinstimmt oder größer als ist, die Windows Vista mit Service Pack 1 (SP1)-Version.
IsWindowsVistaSP2OrGreater Gibt an, ob die aktuelle Betriebssystemversion übereinstimmt oder größer als ist, die Windows Vista mit Service Pack 2 (SP2)-Version.
IsWindows7OrGreater Gibt an, ob die aktuelle Betriebssystemversion mit der Windows 7-Version übereinstimmt oder größer als ist.
IsWindows7SP1OrGreater Gibt an, ob die aktuelle Betriebssystemversion übereinstimmt oder größer als ist, die Windows 7 mit Service Pack 1 (SP1)-Version.
IsWindows8OrGreater Gibt an, ob die aktuelle Betriebssystemversion mit der Windows 8-Version übereinstimmt oder größer als ist.
IsWindows8Point1OrGreater Gibt an, ob die aktuelle Betriebssystemversion mit der Windows 8.1-Version übereinstimmt oder größer als ist.

Für Windows 10 gibt IsWindows8Point1OrGreater "false" zurück, es sei denn, die Anwendung enthält ein Manifest, das einen Kompatibilitätsbereich enthält, der die GUIDs enthält, die Windows 8.1 und/oder Windows 10 festlegen.
IsWindows10OrGreater Gibt an, ob die aktuelle Betriebssystemversion mit der Windows 10-Version übereinstimmt oder größer als ist.

Für Windows 10 gibt IsWindows10OrGreater- "false" zurück, es sei denn, die Anwendung enthält ein Manifest, das einen Kompatibilitätsbereich enthält, der die GUID enthält, die Windows 10 bestimmt.
IsWindowsServer- Gibt an, ob das aktuelle Betriebssystem eine Windows Server-Version ist. Anwendungen, die zwischen Server- und Clientversionen von Windows unterscheiden müssen, sollten diese Funktion aufrufen.
IsWindowsVersionOrGreater Sie sollten diese Funktion nur verwenden, wenn die anderen bereitgestellten Versionshilfsfunktionen nicht in Ihr Szenario passen.

Gibt an, ob die aktuelle Betriebssystemversion mit den bereitgestellten Versionsinformationen übereinstimmt oder größer als ist. Diese Funktion ist nützlich, um eine Version von Windows Server zu bestätigen, die keine Versionsnummer für eine Clientversion freigibt.

Beispiel

Mit den in der VersionHelpers.h Headerdatei definierten Inlinefunktionen können Sie die Betriebssystemversion überprüfen, indem Sie einen booleschen Wert zurückgeben, wenn Sie eine Version von Windows testen.

Wenn Ihre Anwendung beispielsweise Windows 10 oder höher erfordert, verwenden Sie den folgenden Test.

#include <windows.h>
#include <VersionHelpers.h>
 
if (!IsWindows10OrGreater())
{
   MessageBox(NULL, "You need at least Windows 10", "Version Not Supported", MB_OK);
}