Funzione GetProductInfo (sysinfoapi.h)
Recupera il tipo di prodotto per il sistema operativo nel computer locale e esegue il mapping del tipo ai tipi di prodotto supportati dal sistema operativo specificato.
Per recuperare le informazioni sul tipo di prodotto nelle versioni di Windows prima dei sistemi operativi minimi supportati specificati nella sezione Requisiti, usare la funzione GetVersionEx . È anche possibile usare la proprietà OperatingSystemSKU della classe WMI Win32_OperatingSystem .
Sintassi
BOOL GetProductInfo(
[in] DWORD dwOSMajorVersion,
[in] DWORD dwOSMinorVersion,
[in] DWORD dwSpMajorVersion,
[in] DWORD dwSpMinorVersion,
[out] PDWORD pdwReturnedProductType
);
Parametri
[in] dwOSMajorVersion
Numero di versione principale del sistema operativo. Il valore minimo è 6.
La combinazione dei parametri dwOSMajorVersion, dwOSMinorVersion, dwSpMajorVersion e dwSpMinorVersion descrive la versione massima del sistema operativo di destinazione per l'applicazione. Ad esempio, Windows Vista e Windows Server 2008 sono versione 6.0.0.0 e Windows 7 e Windows Server 2008 R2 sono versione 6.1.0.0. Tutte le versioni basate su Windows 10 verranno elencate come versione 6.3.
[in] dwOSMinorVersion
Numero di versione secondaria del sistema operativo. Il valore minimo è 0.
[in] dwSpMajorVersion
Numero di versione principale del Service Pack del sistema operativo. Il valore minimo è 0.
[in] dwSpMinorVersion
Numero di versione secondaria del Service Pack del sistema operativo. Il valore minimo è 0.
[out] pdwReturnedProductType
Tipo di prodotto. Questo parametro non può essere NULL. Se il sistema operativo specificato è minore del sistema operativo corrente, queste informazioni vengono mappate ai tipi supportati dal sistema operativo specificato. Se il sistema operativo specificato è maggiore del sistema operativo supportato più alto, queste informazioni vengono mappate ai tipi supportati dal sistema operativo corrente.
Questo parametro può essere uno dei valori seguenti (alcuni prodotti seguenti potrebbero non essere supportati).
| Valore | Significato |
|---|---|
|
Business |
|
Business N |
|
HPC Edition |
|
Server Hyper Core V |
|
Windows 10 Home |
|
Windows 10 Home Cina |
|
Windows 10 Home N |
|
Windows 10 Home Single Language |
|
Server Datacenter (installazione di valutazione) |
|
Server Datacenter, canale Semi-Annual (installazione principale) |
|
Server Standard, canale Semi-Annual (installazione principale) |
|
Server Datacenter (installazione completa). Per le installazioni di Server Core di Windows Server 2012 e versioni successive, usare il metodo , Determinare se Server Core è in esecuzione. |
|
Server Datacenter (installazione principale, Windows Server 2008 R2 e versioni precedenti) |
|
Server Datacenter senza Hyper-V (installazione principale) |
|
Server Datacenter senza Hyper-V (installazione completa) |
|
Windows 10 Education |
|
Windows 10 Education N |
|
Windows 10 Enterprise |
|
Windows 10 Enterprise E |
|
Windows 10 Enterprise Evaluation |
|
Windows 10 Enterprise N |
|
Windows 10 Enterprise N Evaluation |
|
Windows 10 Enterprise 2015 LTSB |
|
Windows 10 Enterprise 2015 LTSB Evaluation |
|
Windows 10 Enterprise 2015 LTSB N |
|
Windows 10 Enterprise 2015 LTSB N Evaluation |
|
Server Enterprise (installazione completa) |
|
Server Enterprise (installazione principale) |
|
Server Enterprise senza Hyper-V (installazione principale) |
|
Server Enterprise per sistemi basati su Itanium |
|
Server Enterprise senza Hyper-V (installazione completa) |
|
Soluzione Windows Essential Server aggiuntiva |
|
Soluzione SVC aggiuntiva di Windows Essential Server |
|
Gestione soluzioni windows Essential Server |
|
Windows Essential Server Solution Management SVC |
|
Home Basic |
|
Non supportato |
|
Home Basic N |
|
Home Premium |
|
Non supportato |
|
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 commerciale |
|
Server di gestione di Windows Essential Business Server |
|
Server di messaggistica di Windows Essential Business Server |
|
Server di sicurezza di Windows Essential Business Server |
|
Windows 10 Mobile |
|
Windows 10 Mobile Enterprise |
|
Windows MultiPoint Server Premium (installazione completa) |
|
Windows MultiPoint Server Standard (installazione completa) |
|
Windows 10 Team |
|
Windows 10 Pro Education |
|
Windows 10 Pro for Workstations |
|
Windows 10 Pro for Workstations N |
|
Windows 10 Pro |
|
Non supportato |
|
Windows 10 Pro N |
|
Professionale con Media Center |
|
Windows Small Business Server 2011 Essentials |
|
Server per soluzioni SB EM |
|
Server per soluzioni SB |
|
Server per soluzioni SB EM |
|
Soluzioni Windows Server 2008 per Windows Essential Server |
|
Windows Server 2008 senza Hyper-V per soluzioni Windows Essential Server |
|
Server Foundation |
|
Windows 10 Enterprise per Desktop virtuali |
|
Windows Small Business Server |
|
Small Business Server Premium |
|
Small Business Server Premium (installazione principale) |
|
Windows MultiPoint Server |
|
Server Standard (installazione di valutazione) |
|
Server Standard (installazione completa. Per le installazioni Server Core di Windows Server 2012 e versioni successive, usare il metodo Determinare se Server Core è in esecuzione. |
|
Server Standard (installazione principale, Windows Server 2008 R2 e versioni precedenti) |
|
Server Standard senza Hyper-V (installazione principale) |
|
Server Standard senza Hyper-V |
|
Soluzioni server Premium |
|
Server Solutions Premium (installazione principale) |
|
Starter |
|
Non supportato |
|
Starter N |
|
Storage Server Enterprise |
|
Storage Server Enterprise (installazione principale) |
|
Server di archiviazione Express |
|
Storage Server Express (installazione principale) |
|
Storage Server Standard (installazione di valutazione) |
|
Server di archiviazione Standard |
|
Server di archiviazione Standard (installazione principale) |
|
Gruppo di lavoro server di archiviazione (installazione di valutazione) |
|
Gruppo di lavoro server di archiviazione |
|
Gruppo di lavoro server di archiviazione (installazione principale) |
|
Ultimate |
|
Non supportato |
|
Ultimate N |
|
Prodotto sconosciuto |
|
Server Web (installazione completa) |
|
Server Web (installazione principale) |
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Questa funzione ha esito negativo se uno dei parametri di input non è valido.
Commenti
Per rilevare se è installato un ruolo server o una funzionalità, usare il provider WMI funzionalità server .
Le versioni successive di Windows mappano i tipi di prodotto supportati per il set di tipi di prodotto supportati da ogni versione precedente supportata di Windows, tornare alla versione 6.0.0.0. Pertanto, un'applicazione che esegue un test di uguaglianza per uno di questi valori continuerà a funzionare sulle versioni future, anche quando vengono aggiunti nuovi tipi di prodotto.
PRODUCT_*_SERVER_CORE valori non vengono restituiti in Windows Server 2012 e versioni successive. Ad esempio, l'edizione del server di base, Server Datacenter, viene usata per compilare le due diverse opzioni di installazione: "full server" e "core server". Con Windows Server 2012, GetProductInfo restituirà PRODUCT_DATACENTER indipendentemente dall'opzione usata durante l'installazione del prodotto. Come indicato in precedenza, per le installazioni Server Core di Windows Server 2012 e versioni successive, usare il metodo Determina se Server Core è in esecuzione.
La tabella seguente indica i tipi di prodotto introdotti nella versione 6.1.0.0.0 e ciò che verranno mappati se GetProductInfo viene chiamato con la versione 6.0.0.0 in un sistema 6.1.0.0.
| Novità per 6.1.0.0 | Valore restituito con 6.0.0.0 |
|---|---|
| PRODUCT_PROFESSIONAL | PRODUCT_BUSINESS |
| PRODUCT_PROFESSIONAL_N | PRODUCT_BUSINESS_N |
| PRODUCT_STARTER_N | PRODUCT_STARTER |
Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0600 o versioni successive. Per altre informazioni, vedere Uso delle intestazioni di Windows.
Esempio
Per un esempio, vedere Recupero della versione di sistema.
Requisiti
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | sysinfoapi.h (includere Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |