GetVersionExA-Funktion (sysinfoapi.h)

Artikel
03/04/2024

GetVersionExA kann für Releases nach Windows 8.1 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen die Versionshilfsfunktionen. Informationen zu Windows 10 Apps finden Sie unter Targeting your applications for Windows.

Mit der Veröffentlichung von Windows 8.1 hat sich das Verhalten der GetVersionEx-API in dem Wert geändert, der für die Betriebssystemversion zurückgegeben wird. Der von der GetVersionEx-Funktion zurückgegebene Wert hängt jetzt davon ab, wie die Anwendung manifestiert wird.

Anwendungen, die nicht für Windows 8.1 oder Windows 10 manifestiert werden, geben den Wert der Windows 8 Betriebssystemversion (6.2) zurück. Sobald eine Anwendung für eine bestimmte Betriebssystemversion manifestiert wird, gibt GetVersionEx immer die Version zurück, für die die Anwendung in zukünftigen Releases manifestiert wird. Informationen zum Manifestieren Ihrer Anwendungen für Windows 8.1 oder Windows 10 finden Sie unter Targeting ihrer Anwendung für Windows.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE BOOL GetVersionExA(
  [in, out] LPOSVERSIONINFOA lpVersionInformation
);

Parameter

[in, out] lpVersionInformation

Eine OSVERSIONINFOA - oder OSVERSIONINFOEXA-Struktur , die die Betriebssysteminformationen empfängt.

Legen Sie vor dem Aufrufen der GetVersionEx-Funktion den dwOSVersionInfoSize-Member der Struktur als angemessen fest, um anzugeben, welche Datenstruktur an diese Funktion übergeben wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Nichtzero-Wert.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Die Funktion schlägt fehl, wenn Sie einen ungültigen Wert für das dwOSVersionInfoSize-Member der OSVERSIONINFOA - oder OSVERSIONINFOEXA-Struktur angeben.

Hinweise

Die Identifizierung des aktuellen Betriebssystems ist in der Regel nicht die beste Möglichkeit, um zu bestimmen, ob ein bestimmtes Betriebssystemfeature vorhanden ist. Dies liegt daran, dass dem Betriebssystem möglicherweise neue Features in einer verteilbaren DLL hinzugefügt wurden. Anstatt GetVersionEx zu verwenden, um die Betriebssystemplattform oder Versionsnummer zu bestimmen, testen Sie, ob das Feature selbst vorhanden ist. Weitere Informationen finden Sie unter Betriebssystemversion.

Die GetSystemMetrics-Funktion stellt zusätzliche Informationen zum aktuellen Betriebssystem bereit.

Produkt	Einstellung
Windows XP Media Center Edition	SM_MEDIACENTER
Windows XP Starter Edition	SM_STARTER
Windows XP Tablet PC Edition	SM_TABLETPC
Windows Server 2003 R2	SM_SERVERR2

Um nach bestimmten Betriebssystemen oder Betriebssystemfeatures zu suchen, verwenden Sie die IsOS-Funktion . Die GetProductInfo-Funktion ruft den Produkttyp ab.

Um Informationen zum Betriebssystem auf einem Remotecomputer abzurufen, verwenden Sie die NetWkstaGetInfo-Funktion , die Win32_OperatingSystem WMI-Klasse oder die OperatingSystem-Eigenschaft der IADsComputer-Schnittstelle .

Um die aktuelle Systemversion mit einer erforderlichen Version zu vergleichen, verwenden Sie die VerifyVersionInfo-Funktion , anstatt GetVersionEx zu verwenden, um den Vergleich selbst durchzuführen.

Wenn der Kompatibilitätsmodus aktiv ist, meldet die GetVersionEx-Funktion das Betriebssystem so, wie es sich selbst identifiziert, wobei es sich möglicherweise nicht um das installierte Betriebssystem handelt. Wenn beispielsweise der Kompatibilitätsmodus aktiviert ist, meldet GetVersionEx das Betriebssystem, das für die Anwendungskompatibilität ausgewählt ist.

Beispiele

Wenn Sie die GetVersionEx-Funktion verwenden, um zu bestimmen, ob Ihre Anwendung unter einer bestimmten Version des Betriebssystems ausgeführt wird, überprüfen Sie, ob Versionsnummern größer als oder gleich den gewünschten Versionsnummern sind. Dadurch wird sichergestellt, dass der Test für spätere Versionen des Betriebssystems erfolgreich ist. Wenn Ihre Anwendung beispielsweise Windows XP oder höher erfordert, verwenden Sie den folgenden Test.

#include <windows.h>
#include <stdio.h>

void main()
{
    OSVERSIONINFO osvi;
    BOOL bIsWindowsXPorLater;

    ZeroMemory(&osvi, sizeof(OSVERSIONINFO));
    osvi.dwOSVersionInfoSize = sizeof(OSVERSIONINFO);

    GetVersionEx(&osvi);

    bIsWindowsXPorLater = 
       ( (osvi.dwMajorVersion > 5) ||
       ( (osvi.dwMajorVersion == 5) && (osvi.dwMinorVersion >= 1) ));

    if(bIsWindowsXPorLater)
        printf("The system meets the requirements.\n");
    else printf("The system does not meet the requirements.\n");
}

Ein Beispiel, das das aktuelle Betriebssystem identifiziert, finden Sie unter Abrufen der Systemversion.

Hinweis

Der sysinfoapi.h-Header definiert GetVersionEx als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	sysinfoapi.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll