IsWindowsXPSP3OrGreater-Funktion (versionhelpers.h)

Artikel
03/03/2024

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

Syntax

VERSIONHELPERAPI IsWindowsXPSP3OrGreater();

Rückgabewert

True, wenn die aktuelle Betriebssystemversion mit der Windows XP-Version mit SP3 übereinstimmt oder größer ist. Andernfalls false.

Hinweise

Diese Funktion unterscheidet nicht zwischen Client- und Serverversionen. Es wird true zurückgegeben, wenn die aktuelle Versionsnummer des Betriebssystems 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 ein Windows-Clientrelease freigegeben wird, können Sie IsWindowsVersionOrGreater zur Bestätigung verwenden.

Beispiele

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

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

#include <VersionHelpers.h>
…
    if (!IsWindowsXPSP3OrGreater())
    {
       MessageBox(NULL, "You need at least Windows XP with SP3", "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