GetProductInfo, fonction (sysinfoapi.h)

Récupère le type de produit pour le système d’exploitation sur l’ordinateur local et mappe le type aux types de produits pris en charge par le système d’exploitation spécifié.

Pour récupérer des informations sur le type de produit sur les versions de Windows antérieures aux systèmes d’exploitation minimum pris en charge spécifiés dans la section Configuration requise, utilisez la fonction GetVersionEx . Vous pouvez également utiliser la propriété OperatingSystemSKU de la classe WMI Win32_OperatingSystem .

Syntaxe

BOOL GetProductInfo(
  [in]  DWORD  dwOSMajorVersion,
  [in]  DWORD  dwOSMinorVersion,
  [in]  DWORD  dwSpMajorVersion,
  [in]  DWORD  dwSpMinorVersion,
  [out] PDWORD pdwReturnedProductType
);

Paramètres

[in] dwOSMajorVersion

Numéro de version principal du système d’exploitation. La valeur minimale est 6.

La combinaison des paramètres dwOSMajorVersion, dwOSMinorVersion, dwSpMajorVersion et dwSpMinorVersion décrit la version maximale du système d’exploitation cible pour l’application. Par exemple, Windows Vista et Windows Server 2008 sont version 6.0.0.0 et Windows 7 et Windows Server 2008 R2 sont version 6.1.0.0. Toutes les versions basées sur Windows 10 seront répertoriées en tant que version 6.3.

[in] dwOSMinorVersion

Numéro de version secondaire du système d’exploitation. La valeur minimale est 0.

[in] dwSpMajorVersion

Numéro de version principal du service pack du système d’exploitation. La valeur minimale est 0.

[in] dwSpMinorVersion

Numéro de version mineure du Service Pack du système d’exploitation. La valeur minimale est 0.

[out] pdwReturnedProductType

Type de produit. Ce paramètre ne peut pas avoir la valeur NULL. Si le système d’exploitation spécifié est inférieur au système d’exploitation actuel, ces informations sont mappées aux types pris en charge par le système d’exploitation spécifié. Si le système d’exploitation spécifié est supérieur au système d’exploitation le plus élevé pris en charge, ces informations sont mappées aux types pris en charge par le système d’exploitation actuel.

Ce paramètre peut être l’une des valeurs suivantes (certains produits ci-dessous peuvent ne pas être pris en charge).

Valeur retournée

Si la fonction réussit, la valeur de retour est une valeur différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Cette fonction échoue si l’un des paramètres d’entrée n’est pas valide.

Remarques

Pour détecter si un rôle ou une fonctionnalité serveur est installé, utilisez le fournisseur WMI de fonctionnalité serveur.

Les versions ultérieures de Windows mapperont les types de produits qu’il prend en charge à l’ensemble des types de produits pris en charge par chaque version précédente prise en charge de Windows, en revenant à la version 6.0.0.0. Par conséquent, une application qui effectue un test d’égalité pour l’une de ces valeurs continuera à fonctionner sur les versions ultérieures, même lorsque de nouveaux types de produits sont ajoutés.

PRODUCT_*_SERVER_CORE valeurs ne sont pas retournées dans Windows Server 2012 et versions ultérieures. Par exemple, l’édition du serveur de base, Server Datacenter, est utilisée pour générer les deux options d’installation différentes : « serveur complet » et « serveur principal ». Avec Windows Server 2012, GetProductInfo retourne PRODUCT_DATACENTER quelle que soit l’option utilisée lors de l’installation du produit. Comme indiqué ci-dessus, pour les installations Server Core de Windows Server 2012 et versions ultérieures, utilisez la méthode Déterminer si Server Core est en cours d’exécution.

Le tableau suivant indique les types de produits qui ont été introduits dans la version 6.1.0.0, ainsi que leur correspondance si GetProductInfo est appelé avec la version 6.0.0.0 sur un système 6.1.0.0.

Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT comme 0x0600 ou version ultérieure. Pour plus d’informations, consultez Utilisation des en-têtes Windows.

Exemples

Pour obtenir un exemple, consultez Obtention de la version système.

Configuration requise

Voir aussi

Fonctions d’information système