GetProductInfo-Funktion (sysinfoapi.h)
Ruft den Produkttyp für das Betriebssystem auf dem lokalen Computer ab und ordnet den Typ den vom angegebenen Betriebssystem unterstützten Produkttypen zu.
Verwenden Sie die GetVersionEx-Funktion , um Produkttypinformationen zu Versionen von Windows abzurufen, die vor den im Abschnitt Anforderungen angegebenen mindest unterstützten Betriebssystemen gelten. Sie können auch die OperatingSystemSKU-Eigenschaft der Win32_OperatingSystem WMI-Klasse verwenden.
Syntax
BOOL GetProductInfo(
[in] DWORD dwOSMajorVersion,
[in] DWORD dwOSMinorVersion,
[in] DWORD dwSpMajorVersion,
[in] DWORD dwSpMinorVersion,
[out] PDWORD pdwReturnedProductType
);
Parameter
[in] dwOSMajorVersion
Die Hauptversionsnummer des Betriebssystems. Der Mindestwert ist 6.
Die Kombination der Parameter dwOSMajorVersion, dwOSMinorVersion, dwSpMajorVersion und dwSpMinorVersion beschreibt die maximale Zielbetriebssystemversion für die Anwendung. Beispielsweise sind Windows Vista und Windows Server 2008 Version 6.0.0.0 und Windows 7 und Windows Server 2008 R2 sind Version 6.1.0.0. Alle Windows 10 basierten Releases werden als Version 6.3 aufgeführt.
[in] dwOSMinorVersion
Die Nebenversionsnummer des Betriebssystems. Der Mindestwert beträgt 0.
[in] dwSpMajorVersion
Die Hauptversionsnummer des Service Packs des Betriebssystems. Der Mindestwert beträgt 0.
[in] dwSpMinorVersion
Die Nebenversionsnummer des Betriebssystem-Service Packs. Der Mindestwert beträgt 0.
[out] pdwReturnedProductType
Der Produkttyp. Dieser Parameter darf nicht NULL sein. Wenn das angegebene Betriebssystem kleiner als das aktuelle Betriebssystem ist, werden diese Informationen den vom angegebenen Betriebssystem unterstützten Typen zugeordnet. Wenn das angegebene Betriebssystem größer als das höchste unterstützte Betriebssystem ist, werden diese Informationen den vom aktuellen Betriebssystem unterstützten Typen zugeordnet.
Dieser Parameter kann einer der folgenden Werte sein (einige produkte unten können nicht unterstützt werden).
| Wert | Bedeutung |
|---|---|
|
Business |
|
Business N |
|
HPC Edition |
|
Server Hyper Core V |
|
Windows 10 Home |
|
Windows 10 Home China |
|
Windows 10 Home N |
|
Windows 10 Home Single Language |
|
Server datacenter (Evaluierungsinstallation) |
|
Server datacenter, Semi-Annual Channel (Kerninstallation) |
|
Server Standard, Semi-Annual Channel (Kerninstallation) |
|
Server datacenter (vollständige Installation. Verwenden Sie für Server Core-Installationen von Windows Server 2012 und höher die Methode Bestimmen, ob Server Core ausgeführt wird.) |
|
Server Datacenter (Kerninstallation, Windows Server 2008 R2 und früher) |
|
Serverdatencenter ohne Hyper-V (Kerninstallation) |
|
Serverdatencenter ohne Hyper-V (vollständige Installation) |
|
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 (vollständige Installation) |
|
Server Enterprise (Kerninstallation) |
|
Server Enterprise ohne Hyper-V (Kerninstallation) |
|
Server Enterprise für Itanium-basierte Systeme |
|
Server Enterprise ohne Hyper-V (vollständige Installation) |
|
Zusätzliche Windows Essential Server-Lösung |
|
Zusätzliche SVC-Lösung für Windows Essential Server |
|
Windows Essential Server-Lösungsverwaltung |
|
Windows Essential Server Solution Management SVC |
|
Home Basic |
|
Nicht unterstützt |
|
Home Basic N |
|
Home Premium |
|
Nicht unterstützt |
|
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 Commercial |
|
Windows Essential Business Server-Verwaltungsserver |
|
Windows Essential Business Server Messaging Server |
|
Windows Essential Business Server Security Server |
|
Windows 10 Mobile |
|
Windows 10 Mobile Enterprise |
|
Windows MultiPoint Server Premium (vollständige Installation) |
|
Windows MultiPoint Server Standard (vollständige Installation) |
|
Windows 10 Team |
|
Windows 10 Pro Education |
|
Windows 10 Pro for Workstations |
|
Windows 10 Pro for Workstations N |
|
Windows 10 Pro |
|
Nicht unterstützt |
|
Windows 10 Pro N |
|
Professional mit Media Center |
|
Windows Small Business Server 2011 Essentials |
|
Server für SB-Lösungen EM |
|
Server für SB-Lösungen |
|
Server für SB-Lösungen EM |
|
Windows Server 2008 für Windows Essential Server-Lösungen |
|
Windows Server 2008 ohne Hyper-V für Windows Essential Server-Lösungen |
|
Server Foundation |
|
Windows 10 Enterprise für Virtuelle Desktops |
|
Windows Small Business Server |
|
Small Business Server Premium |
|
Small Business Server Premium (Kerninstallation) |
|
Windows MultiPoint Server |
|
Server Standard (Evaluierungsinstallation) |
|
Server Standard (vollständige Installation. Verwenden Sie für Server Core-Installationen von Windows Server 2012 und höher die Methode Ermitteln, ob Server Core ausgeführt wird.) |
|
Server Standard (Core-Installation, Windows Server 2008 R2 und früher) |
|
Server Standard ohne Hyper-V (Core-Installation) |
|
Server Standard ohne Hyper-V |
|
Serverlösungen Premium |
|
Serverlösungen Premium (Kerninstallation) |
|
Starter |
|
Nicht unterstützt |
|
Starter N |
|
Storage Server Enterprise |
|
Storage Server Enterprise (Kerninstallation) |
|
Storage Server Express |
|
Storage Server Express (Kerninstallation) |
|
Storage Server Standard (Evaluierungsinstallation) |
|
Storage Server Standard |
|
Storage Server Standard (Kerninstallation) |
|
Storage Server Workgroup (Evaluierungsinstallation) |
|
Storage Server Workgroup |
|
Storage Server Workgroup (Kerninstallation) |
|
Ultimate |
|
Nicht unterstützt |
|
Ultimate N |
|
Ein unbekanntes Produkt |
|
Webserver (vollständige Installation) |
|
Webserver (Kerninstallation) |
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Nichtzero-Wert.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Diese Funktion schlägt fehl, wenn einer der Eingabeparameter ungültig ist.
Hinweise
Verwenden Sie den Serverfeature-WMI-Anbieter, um zu ermitteln, ob eine Serverrolle oder ein Feature installiert ist.
Nachfolgende Versionen von Windows ordnen die von ihr unterstützten Produkttypen dem Satz von Produkttypen zu, die von jeder unterstützten vorherigen Version von Windows unterstützt werden, zurück zu Version 6.0.0.0. Daher funktioniert eine Anwendung, die einen Gleichheitstest für einen dieser Werte durchführt, auch dann weiterhin, wenn neue Produkttypen hinzugefügt werden.
PRODUCT_*_SERVER_CORE Werte werden in Windows Server 2012 und höher nicht zurückgegeben. Beispielsweise wird die Basisserveredition Server Datacenter verwendet, um die zwei verschiedenen Installationsoptionen zu erstellen: "vollständiger Server" und "Kernserver". Mit Windows Server 2012 gibt GetProductInfo PRODUCT_DATACENTER zurück, unabhängig von der Option, die während der Produktinstallation verwendet wird. Wie oben erwähnt, verwenden Sie für Server Core-Installationen von Windows Server 2012 und höher die Methode Bestimmen, ob Server Core ausgeführt wird.
In der folgenden Tabelle sind die Produkttypen aufgeführt, die in Version 6.1.0.0 eingeführt wurden, und was sie zuordnen, wenn GetProductInfo mit Version 6.0.0.0 auf einem 6.1.0.0-System aufgerufen wird.
| Neu für 6.1.0.0 | Wert, der mit 6.0.0.0 zurückgegeben wird |
|---|---|
| PRODUCT_PROFESSIONAL | PRODUCT_BUSINESS |
| PRODUCT_PROFESSIONAL_N | PRODUCT_BUSINESS_N |
| PRODUCT_STARTER_N | PRODUCT_STARTER |
Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0600 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.
Beispiele
Ein Beispiel finden Sie unter Abrufen der Systemversion.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | sysinfoapi.h (einschließlich Windows.h) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |