Fungsi GetVersion (sysinfoapi.h)

  • Artikel

GetVersion dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan fungsi Pembantu Versi. Untuk aplikasi Windows 10, silakan lihat Menargetkan aplikasi Anda untuk Windows.

Dengan rilis Windows 8.1, perilaku GETVersion API telah berubah dalam nilai yang akan dikembalikan untuk versi sistem operasi. Nilai yang dikembalikan oleh fungsi GetVersion sekarang tergantung pada bagaimana aplikasi dimanifestasikan.

Aplikasi yang tidak dimanifestasikan untuk Windows 8.1 atau Windows 10 akan mengembalikan nilai versi OS Windows 8 (6.2). Setelah aplikasi dimanifestasikan untuk versi sistem operasi tertentu, GetVersion akan selalu mengembalikan versi yang dimanifestasikan aplikasi untuk rilis mendatang. Untuk memanifestasikan aplikasi Anda untuk Windows 8.1 atau Windows 10, lihat Menargetkan aplikasi Anda untuk Windows.

Sintaks

NOT_BUILD_WINDOWS_DEPRECATE DWORD GetVersion();

Mengembalikan nilai

Jika fungsi berhasil, nilai pengembalian menyertakan nomor versi utama dan minor dari sistem operasi dalam kata urutan rendah, dan informasi tentang platform sistem operasi dalam kata urutan tinggi.

Untuk semua platform, kata berurutan rendah berisi nomor versi sistem operasi. Byte urutan rendah kata ini menentukan nomor versi utama, dalam notasi heksadesimal. Byte urutan tinggi menentukan nomor versi minor (revisi), dalam notasi heksadesimal. Bit urutan tinggi adalah nol, 7 bit berikutnya mewakili angka build, dan byte urutan rendah adalah 5.

Keterangan

Fungsi GetVersionEx dikembangkan karena banyak aplikasi yang ada err saat memeriksa nilai DWORD yang dikemas yang dikembalikan oleh GetVersion, mengubah nomor versi utama dan minor. GetVersionEx memaksa aplikasi untuk secara eksplisit memeriksa setiap elemen informasi versi. VerifyVersionInfo menghilangkan potensi kesalahan lebih lanjut dengan membandingkan versi sistem yang diperlukan dengan versi sistem saat ini untuk Anda.

Contoh

Fragmen kode berikut menggambarkan cara mengekstrak informasi dari nilai pengembalian GetVersion : 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);
}

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header sysinfoapi.h (termasuk Windows.h)
Pustaka Kernel32.lib
DLL Kernel32.dll

Lihat juga