GetVersion-Funktion (sysinfoapi.h)

  • Artikel

GetVersion 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 GetVersion-API in dem Wert geändert, der für die Betriebssystemversion zurückgegeben wird. Der von der GetVersion-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 ist, gibt GetVersion 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 DWORD GetVersion();

Rückgabewert

Wenn die Funktion erfolgreich ist, enthält der Rückgabewert die Haupt- und Nebenversionsnummern des Betriebssystems im Wort mit niedriger Reihenfolge sowie Informationen zur Betriebssystemplattform im Wort "Hohe Ordnung".

Für alle Plattformen enthält das Wort mit niedriger Reihenfolge die Versionsnummer des Betriebssystems. Das Byte in niedriger Reihenfolge dieses Worts gibt die Hauptversionsnummer in Hexadezimalschreibweise an. Das Hochreihenfolge-Byte gibt die Nebenversionsnummer (Revisionsnummer) in hexadezimaler Notation an. Das hochgeordnete Bit ist 0, die nächsten 7 Bits stellen die Buildnummer dar, und das Byte mit niedriger Reihenfolge ist 5.

Hinweise

Die GetVersionEx-Funktion wurde entwickelt, weil viele vorhandene Anwendungen fehlern, wenn sie den von GetVersion zurückgegebenen gepackten DWORD-Wert untersuchen und die Haupt- und Nebenversionsnummern transponieren. GetVersionEx zwingt Anwendungen, jedes Element der Versionsinformationen explizit zu untersuchen. VerifyVersionInfo beseitigt weitere Fehlerpotenziale, indem die erforderliche Systemversion mit der aktuellen Systemversion für Sie verglichen wird.

Beispiele

Das folgende Codefragment veranschaulicht, wie Informationen aus dem GetVersion-Rückgabewert extrahiert werden: OSVERSIONINFOEX

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

void main()
{
    DWORD dwVersion = 0; 
    DWORD dwMajorVersion = 0;
    DWORD dwMinorVersion = 0; 
    DWORD dwBuild = 0;

    dwVersion = GetVersion();
 
    // Get the Windows version.

    dwMajorVersion = (DWORD)(LOBYTE(LOWORD(dwVersion)));
    dwMinorVersion = (DWORD)(HIBYTE(LOWORD(dwVersion)));

    // Get the build number.

    if (dwVersion < 0x80000000)              
        dwBuild = (DWORD)(HIWORD(dwVersion));

    printf("Version is %d.%d (%d)\n", 
                dwMajorVersion,
                dwMinorVersion,
                dwBuild);
}

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 sysinfoapi.h (einschließlich Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch