Fonctions d’assistance de version

  • Article

Les fonctions suivantes peuvent être utilisées pour déterminer la version actuelle du système d’exploitation ou pour déterminer s’il s’agit d’une version Windows ou Windows Server. Ces fonctions fournissent des tests simples qui utilisent la fonction VerifyVersionInfo et les recommandations supérieures ou égales à des comparaisons qui se sont avérées être un moyen robuste de déterminer la version du système d’exploitation.

Notes

Ces API sont définies par versionhelpers.h, qui est inclus dans le kit de développement logiciel (SDK) Windows 8.1. Ce fichier peut être utilisé avec d’autres versions de Microsoft Visual Studio pour implémenter les mêmes fonctionnalités pour les versions de Windows antérieures à Windows 8.1.

Fonction Description
IsWindowsXPOrGreater Indique si la version actuelle du système d’exploitation correspond ou est supérieure à la version de Windows XP.
IsWindowsXPSP1OrGreater Indique si la version actuelle du système d’exploitation correspond ou est supérieure à la version de Windows XP avec Service Pack 1 (SP1).
IsWindowsXPSP2OrGreater Indique si la version actuelle du système d’exploitation correspond ou est supérieure à la version de Windows XP avec Service Pack 2 (SP2).
IsWindowsXPSP3OrGreater Indique si la version actuelle du système d’exploitation correspond ou est supérieure à la version de Windows XP avec Service Pack 3 (SP3).
IsWindowsVistaOrGreater Indique si la version actuelle du système d’exploitation correspond ou est supérieure à la version de Windows Vista.
IsWindowsVistaSP1OrGreater Indique si la version actuelle du système d’exploitation correspond ou est supérieure à la version de Windows Vista avec Service Pack 1 (SP1).
IsWindowsVistaSP2OrGreater Indique si la version actuelle du système d’exploitation correspond ou est supérieure à celle de Windows Vista avec Service Pack 2 (SP2).
IsWindows7OrGreater Indique si la version actuelle du système d’exploitation correspond ou est supérieure à la version de Windows 7.
IsWindows7SP1OrGreater Indique si la version actuelle du système d’exploitation correspond ou est supérieure à la version de Windows 7 avec Service Pack 1 (SP1).
IsWindows8OrGreater Indique si la version actuelle du système d’exploitation correspond ou est supérieure à la version Windows 8.
IsWindows8Point1OrGreater Indique si la version actuelle du système d’exploitation correspond ou est supérieure à la version Windows 8.1.
Pour Windows 10, IsWindows8Point1OrGreater retourne false, sauf si l’application contient un manifeste qui inclut une section de compatibilité qui contient les GUID qui désignent Windows 8.1 et/ou Windows 10.
IsWindows10OrGreater Indique si la version actuelle du système d’exploitation correspond ou est supérieure à la version Windows 10.
Pour Windows 10, IsWindows10OrGreater retourne false, sauf si l’application contient un manifeste qui inclut une section de compatibilité qui contient le GUID qui désigne Windows 10.
IsWindowsServer Indique si le système d’exploitation actuel est une version de Windows Server. Les applications qui doivent faire la distinction entre les versions serveur et cliente de Windows doivent appeler cette fonction.
IsWindowsVersionOrGreater Vous ne devez utiliser cette fonction que si les autres fonctions d’assistance de version fournies ne correspondent pas à votre scénario.
Indique si la version actuelle du système d’exploitation correspond ou est supérieure aux informations de version fournies. Cette fonction est utile pour confirmer une version de Windows Server qui ne partage pas de numéro de version avec une version cliente.

Exemple

Les fonctions inline définies dans le fichier d’en-tête VersionHelpers.h vous permettent de vérifier la version du système d’exploitation en retournant une valeur booléenne lors du test d’une version de Windows.

Par exemple, si votre application nécessite Windows 8 ou une version ultérieure, utilisez le test suivant.

#include <VersionHelpers.h>
 
if (!IsWindows8OrGreater())
{
   MessageBox(NULL, "You need at least Windows 8", "Version Not Supported", MB_OK);
}