Struktur OSVERSIONINFOEXA (winnt.h)

Artikel
03/08/2023

Berisi informasi versi sistem operasi. Informasi tersebut mencakup nomor versi utama dan minor, nomor build, pengidentifikasi platform, dan informasi tentang suite produk dan Paket Layanan terbaru yang diinstal pada sistem. Struktur ini digunakan dengan fungsi GetVersionEx dan VerifyVersionInfo .

Sintaks

typedef struct _OSVERSIONINFOEXA {
  DWORD dwOSVersionInfoSize;
  DWORD dwMajorVersion;
  DWORD dwMinorVersion;
  DWORD dwBuildNumber;
  DWORD dwPlatformId;
  CHAR  szCSDVersion[128];
  WORD  wServicePackMajor;
  WORD  wServicePackMinor;
  WORD  wSuiteMask;
  BYTE  wProductType;
  BYTE  wReserved;
} OSVERSIONINFOEXA, *POSVERSIONINFOEXA, *LPOSVERSIONINFOEXA;

Anggota

dwOSVersionInfoSize

Ukuran struktur data ini, dalam byte. Atur anggota ini ke sizeof(OSVERSIONINFOEX).

dwMajorVersion

Nomor versi utama sistem operasi. Untuk informasi selengkapnya, lihat Keterangan.

dwMinorVersion

Nomor versi minor sistem operasi. Untuk informasi selengkapnya, lihat Keterangan.

dwBuildNumber

Nomor build sistem operasi.

dwPlatformId

Platform sistem operasi. Anggota ini dapat VER_PLATFORM_WIN32_NT (2).

szCSDVersion[128]

String yang dihentikan null, seperti "Paket Layanan 3", yang menunjukkan Paket Layanan terbaru yang diinstal pada sistem. Jika tidak ada Paket Layanan yang diinstal, string kosong.

wServicePackMajor

Nomor versi utama paket layanan terbaru yang diinstal pada sistem. Misalnya, untuk Paket Layanan 3, nomor versi utama adalah 3. Jika tidak ada Paket Layanan yang diinstal, nilainya adalah nol.

wServicePackMinor

Nomor versi minor dari Paket Layanan terbaru yang diinstal pada sistem. Misalnya, untuk Paket Layanan 3, nomor versi minor adalah 0.

wSuiteMask

Sedikit masker yang mengidentifikasi suite produk yang tersedia pada sistem. Anggota ini bisa menjadi kombinasi dari nilai berikut.

Nilai	Makna
VER_SUITE_BACKOFFICE 0x00000004	Komponen Microsoft BackOffice diinstal.
VER_SUITE_BLADE 0x00000400	Windows Server 2003, Edisi Web diinstal.
VER_SUITE_COMPUTE_SERVER 0x00004000	Windows Server 2003, Edisi Kluster Komputasi diinstal.
VER_SUITE_DATACENTER 0x00000080	Pusat Data Windows Server 2008, Windows Server 2003, Edisi Pusat Data, atau Server Pusat Data Windows 2000 diinstal.
VER_SUITE_ENTERPRISE 0x00000002	Windows Server 2008 Enterprise, Windows Server 2003, Enterprise Edition, atau Windows 2000 Advanced Server diinstal. Lihat bagian Keterangan untuk informasi selengkapnya tentang bendera bit ini.
VER_SUITE_EMBEDDEDNT 0x00000040	Windows XP Embedded terinstal.
VER_SUITE_PERSONAL 0x00000200	Windows Vista Home Premium, Windows Vista Home Basic, atau Windows XP Home Edition terinstal.
VER_SUITE_SINGLEUSERTS 0x00000100	Desktop Jauh didukung, tetapi hanya satu sesi interaktif yang didukung. Nilai ini diatur kecuali sistem berjalan dalam mode server aplikasi.
VER_SUITE_SMALLBUSINESS 0x00000001	Microsoft Small Business Server pernah diinstal pada sistem, tetapi mungkin telah dimutakhirkan ke versi Windows lain. Lihat bagian Keterangan untuk informasi selengkapnya tentang bendera bit ini.
VER_SUITE_SMALLBUSINESS_RESTRICTED 0x00000020	Microsoft Small Business Server diinstal dengan lisensi klien terbatas yang berlaku. Lihat bagian Keterangan untuk informasi selengkapnya tentang bendera bit ini.
VER_SUITE_STORAGE_SERVER 0x00002000	Windows Storage Server 2003 R2 atau Windows Storage Server 2003is terinstal.
VER_SUITE_TERMINAL 0x00000010	Layanan Terminal diinstal. Nilai ini selalu diatur. Jika VER_SUITE_TERMINAL diatur tetapi VER_SUITE_SINGLEUSERTS tidak diatur, sistem berjalan dalam mode server aplikasi.
VER_SUITE_WH_SERVER 0x00008000	Windows Home Server terinstal.
VER_SUITE_MULTIUSERTS 0x00020000	Mode AppServer diaktifkan.

wProductType

Informasi tambahan apa pun tentang sistem. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
VER_NT_DOMAIN_CONTROLLER 0x0000002	Sistem ini adalah pengendali domain dan sistem operasinya adalah Windows Server 2012, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, atau Windows 2000 Server.
VER_NT_SERVER 0x0000003	Sistem operasinya adalah Windows Server 2012, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, atau Windows 2000 Server. Perhatikan bahwa server yang juga pengendali domain dilaporkan sebagai VER_NT_DOMAIN_CONTROLLER, bukan VER_NT_SERVER.
VER_NT_WORKSTATION 0x0000001	Sistem operasinya Windows 8, Windows 7, Windows Vista, Windows XP Professional, Windows XP Home Edition, atau Windows 2000 Professional.

wReserved

Disiapkan untuk penggunaan masa mendatang.

Keterangan

Mengandalkan informasi versi bukanlah cara terbaik untuk menguji fitur. Sebagai gantinya, lihat dokumentasi untuk fitur yang menarik. Untuk informasi selengkapnya tentang teknik umum untuk deteksi fitur, lihat Versi Sistem Operasi.

Jika Anda harus memerlukan sistem operasi tertentu, pastikan untuk menggunakannya sebagai versi minimum yang didukung, daripada merancang pengujian untuk satu sistem operasi. Dengan cara ini, kode deteksi Anda akan terus berfungsi pada versi Windows yang akan datang.

Tabel berikut ini meringkas nilai yang dikembalikan oleh versi Windows yang didukung. Gunakan informasi dalam kolom berlabel "Lainnya" untuk membedakan antara sistem operasi dengan nomor versi yang identik.

Sistem operasi	Nomor Versi	dwMajorVersion	dwMinorVersion	Lainnya
Windows 10	10.0*	10	0	OSVERSIONINFOEX.wProductType == VER_NT_WORKSTATION
Server Windows 2016	10.0*	10	0	OSVERSIONINFOEX.wProductType != VER_NT_WORKSTATION
Windows 8.1	6.3*	6	3	OSVERSIONINFOEX.wProductType == VER_NT_WORKSTATION
Windows Server 2012 R2	6.3*	6	3	OSVERSIONINFOEX.wProductType != VER_NT_WORKSTATION
Windows 8	6.2	6	2	OSVERSIONINFOEX.wProductType == VER_NT_WORKSTATION
Windows Server 2012	6.2	6	2	OSVERSIONINFOEX.wProductType != VER_NT_WORKSTATION
Windows 7	6.1	6	1	OSVERSIONINFOEX.wProductType == VER_NT_WORKSTATION
Windows Server 2008 R2	6.1	6	1	OSVERSIONINFOEX.wProductType != VER_NT_WORKSTATION
Windows Server 2008	6.0	6	0	OSVERSIONINFOEX.wProductType != VER_NT_WORKSTATION
Windows Vista	6.0	6	0	OSVERSIONINFOEX.wProductType == VER_NT_WORKSTATION
Windows Server 2003 R2	5.2	5	2	GetSystemMetrics(SM_SERVERR2) != 0
Windows Home Server	5.2	5	2	OSVERSIONINFOEX.wSuiteMask & VER_SUITE_WH_SERVER
Windows Server 2003	5.2	5	2	GetSystemMetrics(SM_SERVERR2) == 0
Windows XP Professional x64 Edition	5.2	5	2	(OSVERSIONINFOEX.wProductType == VER_NT_WORKSTATION) && (SYSTEM_INFO.wProcessorArchitecture==PROCESSOR_ARCHITECTURE_AMD64)
Windows XP	5.1	5	1	Tidak berlaku
Windows 2000	5.0	5	0	Tidak berlaku
*Untuk aplikasi yang telah dimanifestasikan untuk Windows 8.1 atau Windows 10. Aplikasi yang tidak dimanifestasikan untuk Windows 8.1 atau Windows 10 akan mengembalikan nilai versi OS Windows 8 (6.2). Untuk memanifestasikan aplikasi Anda untuk Windows 8.1 atau Windows 10, lihat Menargetkan aplikasi Anda untuk Windows.

Anda tidak boleh hanya mengandalkan bendera VER_SUITE_SMALLBUSINESS untuk menentukan apakah Small Business Server telah diinstal pada sistem, karena bendera ini dan bendera VER_SUITE_SMALLBUSINESS_RESTRICTED diatur ketika rangkaian produk ini diinstal. Jika Anda memutakhirkan penginstalan ini ke Windows Server, Edisi Standar, bendera VER_SUITE_SMALLBUSINESS_RESTRICTED akan dihapus—namun, bendera VER_SUITE_SMALLBUSINESS akan tetap ditetapkan. Dalam hal ini, ini menunjukkan bahwa Small Business Server pernah diinstal pada sistem ini. Jika penginstalan ini ditingkatkan lebih lanjut ke Windows Server, Enterprise Edition, bendera VER_SUITE_SMALLBUSINESS akan tetap diatur.

Jika mode kompatibilitas berlaku, struktur OSVERSIONINFOEX berisi informasi tentang sistem operasi yang dipilih untuk kompatibilitas aplikasi.

Untuk menentukan apakah aplikasi berbasis Win32 berjalan di WOW64, panggil fungsi IsWow64Process . Untuk menentukan apakah sistem menjalankan Windows versi 64-bit, panggil fungsi GetNativeSystemInfo .

Fungsi GetSystemMetrics menyediakan informasi tambahan berikut tentang sistem operasi saat ini.

Produk	Pengaturan
Windows Server 2003 R2	SM_SERVERR2
Windows XP Media Center Edition	SM_MEDIACENTER
Windows XP Starter Edition	SM_STARTER
Windows XP Tablet Edisi PC	SM_TABLETPC

Contoh

Misalnya, lihat Mendapatkan Versi Sistem.

Catatan

Header winnt.h mendefinisikan OSVERSIONINFOEX sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	winnt.h (termasuk Windows.h)

Lihat juga

IsWow64Process

OSVERSIONINFO

API Pembantu Versi

Share via