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).

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.

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

Siehe auch

Systeminformationsfunktionen