IsWindowsXPSP2OrGreater-Funktion (versionhelpers.h)

Artikel
03/03/2024

Gibt an, ob die aktuelle Betriebssystemversion mit der Version von Windows XP mit Service Pack 2 (SP2) übereinstimmt oder größer ist.

Syntax

VERSIONHELPERAPI IsWindowsXPSP2OrGreater();

Rückgabewert

True, wenn die aktuelle Betriebssystemversion mit windows XP mit der SP2-Versionsnummer übereinstimmt oder größer als ist; andernfalls false.

Hinweise

Diese Funktion unterscheidet nicht zwischen Client- und Serverversionen. Es wird true zurückgegeben, wenn die aktuelle Betriebssystemversionsnummer gleich oder höher ist als die Version des Clients, die im Aufruf benannt ist. Beispielsweise gibt ein Aufruf von IsWindowsXPSP3OrGreater unter Windows Server 2008 true zurück. Anwendungen, die zwischen Server- und Clientversionen von Windows unterscheiden müssen, sollten IsWindowsServer aufrufen.

In Situationen, in denen eine Windows Server-Versionsnummer nicht für eine Windows-Clientversion freigegeben wird, können Sie IsWindowsVersionOrGreater verwenden, um dies zu bestätigen.

Beispiele

Mit den in der Headerdatei VersionHelpers.h definierten Inlinefunktionen können Sie die Betriebssystemversion überprüfen, indem Sie beim Testen für eine Windows-Version einen booleschen Wert zurückgeben.

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

#include <VersionHelpers.h>
…
    if (!IsWindowsXPSP2OrGreater())
    {
       MessageBox(NULL, "You need at least Windows XP with SP2", "Version Not Supported", MB_OK);
    }

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	versionhelpers.h
Bibliothek	Kernel32.lib; Ntdll.lib
DLL	Kernel32.dll; Ntdll.dll