Fungsi GetProductInfo (sysinfoapi.h)
Mengambil jenis produk untuk sistem operasi di komputer lokal, dan memetakan jenis ke jenis produk yang didukung oleh sistem operasi yang ditentukan.
Untuk mengambil informasi jenis produk pada versi Windows sebelum sistem operasi minimum yang didukung yang ditentukan di bagian Persyaratan, gunakan fungsi GetVersionEx . Anda juga dapat menggunakan properti OperatingSystemSKU dari kelas WMI Win32_OperatingSystem .
Sintaks
BOOL GetProductInfo(
[in] DWORD dwOSMajorVersion,
[in] DWORD dwOSMinorVersion,
[in] DWORD dwSpMajorVersion,
[in] DWORD dwSpMinorVersion,
[out] PDWORD pdwReturnedProductType
);
Parameter
[in] dwOSMajorVersion
Nomor versi utama sistem operasi. Nilai minimumnya adalah 6.
Kombinasi parameter dwOSMajorVersion, dwOSMinorVersion, dwSpMajorVersion, dan dwSpMinorVersion menjelaskan versi sistem operasi target maksimum untuk aplikasi. Misalnya, Windows Vista dan Windows Server 2008 adalah versi 6.0.0.0 dan Windows 7 dan Windows Server 2008 R2 adalah versi 6.1.0.0. Semua rilis berbasis Windows 10 akan terdaftar sebagai versi 6.3.
[in] dwOSMinorVersion
Nomor versi minor dari sistem operasi. Nilai minimumnya adalah 0.
[in] dwSpMajorVersion
Nomor versi utama paket layanan sistem operasi. Nilai minimumnya adalah 0.
[in] dwSpMinorVersion
Nomor versi minor dari paket layanan sistem operasi. Nilai minimumnya adalah 0.
[out] pdwReturnedProductType
Jenis produk. Parameter ini tidak boleh NULL. Jika sistem operasi yang ditentukan kurang dari sistem operasi saat ini, informasi ini dipetakan ke jenis yang didukung oleh sistem operasi yang ditentukan. Jika sistem operasi yang ditentukan lebih besar dari sistem operasi tertinggi yang didukung, informasi ini dipetakan ke jenis yang didukung oleh sistem operasi saat ini.
Parameter ini bisa menjadi salah satu nilai berikut (beberapa produk di bawah ini mungkin tidak didukung).
| Nilai | Makna |
|---|---|
|
Bisnis |
|
Bisnis N |
|
HPC Edition |
|
Server Hyper Core V |
|
Windows 10 Home |
|
Windows 10 Home Tiongkok |
|
Windows 10 Home N |
|
Windows 10 Home Single Language |
|
Pusat Data Server (penginstalan evaluasi) |
|
Pusat Data Server, saluran Semi-Annual (penginstalan inti) |
|
Server Standard, Semi-Annual Channel (penginstalan inti) |
|
Pusat Data Server (penginstalan penuh. Untuk penginstalan Server Core Windows Server 2012 dan yang lebih baru, gunakan metode , Menentukan apakah Server Core sedang berjalan.) |
|
Pusat Data Server (penginstalan inti, Windows Server 2008 R2 dan yang lebih lama) |
|
Pusat Data Server tanpa Hyper-V (penginstalan inti) |
|
Pusat Data Server tanpa Hyper-V (penginstalan penuh) |
|
Windows 10 Education |
|
Windows 10 Education N |
|
Windows 10 Enterprise |
|
Windows 10 Enterprise E |
|
Windows 10 Enterprise Evaluation |
|
Windows 10 Enterprise N |
|
Evaluasi N Windows 10 Enterprise |
|
Windows 10 Enterprise 2015 LTSB |
|
Windows 10 Enterprise 2015 LTSB Evaluation |
|
Windows 10 Enterprise 2015 LTSB N |
|
Evaluasi Windows 10 Enterprise 2015 LTSB N |
|
Server Enterprise (penginstalan penuh) |
|
Server Enterprise (penginstalan inti) |
|
Server Enterprise tanpa Hyper-V (penginstalan inti) |
|
Server Enterprise untuk Sistem berbasis Itanium |
|
Server Enterprise tanpa Hyper-V (penginstalan penuh) |
|
Solusi Windows Essential Server Tambahan |
|
Solusi Windows Essential Server SVC Tambahan |
|
Manajemen Solusi Windows Essential Server |
|
Windows Essential Server Solution Management SVC |
|
Home Basic |
|
Tidak didukung |
|
Home Basic N |
|
Home Premium |
|
Tidak didukung |
|
Home Premium N |
|
Windows Home Server 2011 |
|
Windows Storage Server 2008 R2 Essentials |
|
Microsoft Hyper-V Server |
|
Windows IoT Enterprise |
|
Windows IoT Enterprise LTSC |
|
Windows 10 IoT Core |
|
Windows 10 IoT Core Komersial |
|
Windows Essential Business Server Management Server |
|
Windows Essential Business Server Messaging Server |
|
Server Keamanan Windows Essential Business Server |
|
Windows 10 Mobile |
|
Windows 10 Mobile Enterprise |
|
Windows MultiPoint Server Premium (penginstalan penuh) |
|
Windows MultiPoint Server Standard (penginstalan penuh) |
|
Tim Windows 10 |
|
Windows 10 Pro Education |
|
Windows 10 Pro for Workstations |
|
Windows 10 Pro for Workstations N |
|
Windows 10 Pro |
|
Tidak didukung |
|
Windows 10 Pro N |
|
Profesional dengan Media Center |
|
Windows Small Business Server 2011 Essentials |
|
Server untuk SB Solutions EM |
|
Server untuk solusi SB |
|
Server untuk SB Solutions EM |
|
Windows Server 2008 untuk Windows Essential Server Solutions |
|
Windows Server 2008 tanpa Hyper-V untuk Windows Essential Server Solutions |
|
Server Foundation |
|
Windows 10 Enterprise untuk Virtual Desktop |
|
Windows Small Business Server |
|
Small Business Server Premium |
|
Small Business Server Premium (penginstalan inti) |
|
Windows MultiPoint Server |
|
Standar Server (penginstalan evaluasi) |
|
Standar Server (penginstalan penuh. Untuk penginstalan Server Core Windows Server 2012 dan yang lebih baru, gunakan metode , Menentukan apakah Server Core berjalan.) |
|
Server Standard (penginstalan inti, Windows Server 2008 R2 dan yang lebih lama) |
|
Standar Server tanpa Hyper-V (penginstalan inti) |
|
Standar Server tanpa Hyper-V |
|
Solusi Server Premium |
|
Server Solutions Premium (penginstalan inti) |
|
Starter |
|
Tidak didukung |
|
Starter N |
|
Storage Server Enterprise |
|
Storage Server Enterprise (penginstalan inti) |
|
Storage Server Express |
|
Storage Server Express (penginstalan inti) |
|
Storage Server Standard (penginstalan evaluasi) |
|
Standar Server Penyimpanan |
|
Storage Server Standard (penginstalan inti) |
|
Grup Kerja Server Penyimpanan (penginstalan evaluasi) |
|
Grup Kerja Server Penyimpanan |
|
Grup Kerja Server Penyimpanan (penginstalan inti) |
|
Ultimate |
|
Tidak didukung |
|
Ultimate N |
|
Produk yang tidak diketahui |
|
Server Web (penginstalan penuh) |
|
Server Web (penginstalan inti) |
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan adalah nilai bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Fungsi ini gagal jika salah satu parameter input tidak valid.
Keterangan
Untuk mendeteksi apakah peran atau fitur server diinstal, gunakan penyedia WMI Fitur Server .
Rilis Windows berikutnya akan memetakan jenis produk yang didukungnya ke kumpulan jenis produk yang didukung oleh setiap rilis Windows sebelumnya yang didukung, kembali ke versi 6.0.0.0. Oleh karena itu, aplikasi yang melakukan pengujian kesetaraan untuk salah satu nilai ini akan terus bekerja pada rilis mendatang, bahkan ketika jenis produk baru ditambahkan.
PRODUCT_*nilai _SERVER_CORE tidak dikembalikan di Windows Server 2012, dan yang lebih baru. Misalnya, edisi server dasar, Server Datacenter, digunakan untuk membangun dua opsi penginstalan yang berbeda: "server penuh" dan "server inti". Dengan Windows Server 2012, GetProductInfo akan mengembalikan PRODUCT_DATACENTER terlepas dari opsi yang digunakan selama penginstalan produk. Seperti disebutkan di atas, untuk penginstalan Server Core Windows Server 2012 dan yang lebih baru, gunakan metode Menentukan apakah Server Core berjalan.
Tabel berikut menunjukkan jenis produk yang diperkenalkan di 6.1.0.0, dan apa yang akan mereka petakan jika GetProductInfo dipanggil dengan versi 6.0.0.0 pada sistem 6.1.0.0.
| Baru untuk 6.1.0.0 | Nilai yang dikembalikan dengan 6.0.0.0 |
|---|---|
| PRODUCT_PROFESSIONAL | PRODUCT_BUSINESS |
| PRODUCT_PROFESSIONAL_N | PRODUCT_BUSINESS_N |
| PRODUCT_STARTER_N | PRODUCT_STARTER |
Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0600 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.
Contoh
Misalnya, lihat Mendapatkan Versi Sistem.
Persyaratan
| Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | sysinfoapi.h (sertakan Windows.h) |
| Pustaka | Kernel32.lib |
| DLL | Kernel32.dll |