Fonctions d’assistance de version
Les fonctions suivantes peuvent être utilisées pour déterminer la version actuelle du système d’exploitation ou 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 la fonction recommandée supérieure ou égale aux comparaisons qui sont prouvées comme un moyen robuste de déterminer la version du système d’exploitation.
Note
Ces API sont définies par versionhelpers.h, qui est inclus dans le Kit de développement logiciel Windows (SDK) pour Windows 8.1 et versions ultérieures. 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.
Note
Versionhelpers.h nécessite windows.h d’être inclus avant celui-ci.
| Fonction | Description |
|---|---|
| IsWindowsXPOrGreater | Indique si la version actuelle du système d’exploitation correspond ou est supérieure à celle de Windows XP. |
| IsWindowsXPSP1OrGreater | Indique si la version actuelle du système d’exploitation correspond ou est supérieure à celle de Windows XP avec Service Pack 1 (SP1). |
| IsWindowsXPSP2OrGreater | Indique si la version actuelle du système d’exploitation correspond ou est supérieure à celle de Windows XP avec Service Pack 2 (SP2). |
| IsWindowsXPSP3OrGreater | Indique si la version actuelle du système d’exploitation correspond ou est supérieure à celle de Windows XP avec Service Pack 3 (SP3). |
| IsWindowsVistaOrGreater | Indique si la version actuelle du système d’exploitation correspond ou est supérieure à celle de Windows Vista. |
| IsWindowsVistaSP1OrGreater | Indique si la version actuelle du système d’exploitation correspond ou est supérieure à celle 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 à celle de Windows 7. |
| IsWindows7SP1OrGreater | Indique si la version actuelle du système d’exploitation correspond ou est supérieure à celle de Windows 7 avec Service Pack 1 (SP1). |
| IsWindows8OrGreater | Indique si la version actuelle du système d’exploitation correspond ou est supérieure à celle de Windows 8. |
| IsWindows8Point1OrGreater | Indique si la version actuelle du système d’exploitation correspond ou est supérieure à celle de 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 à celle de 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 client 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 à celle fournie. 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 10 ou version ultérieure, utilisez le test suivant.
#include <windows.h>
#include <VersionHelpers.h>
if (!IsWindows10OrGreater())
{
MessageBox(NULL, "You need at least Windows 10", "Version Not Supported", MB_OK);
}