Funzioni helper della versione

  • Articolo

Le funzioni seguenti possono essere usate per determinare la versione corrente del sistema operativo o identificare se si tratta di una versione di Windows o Windows Server. Queste funzioni forniscono test semplici che usano la funzione VerifyVersionInfo e i confronti consigliati maggiori o uguali a quelli comprovati come strumenti affidabili per determinare la versione del sistema operativo.

Nota

Queste API sono definite da versionhelpers.h, incluso in Windows Software Development Kit (SDK) per Windows 8.1 e versioni successive. Questo file può essere usato con altre versioni di Microsoft Visual Studio per implementare le stesse funzionalità per le versioni di Windows precedenti a Windows 8.1.

Nota

Versionhelpers.h richiede che windows.h sia incluso prima.

Funzione Descrizione
IsWindowsXPOrGreater Indica se la versione corrente del sistema operativo corrisponde o è maggiore di, la versione di Windows XP.
IsWindowsXPSP1OrGreater Indica se la versione corrente del sistema operativo corrisponde o è maggiore di, la versione di Windows XP con Service Pack 1 (SP1).
IsWindowsXPSP2OrGreater Indica se la versione corrente del sistema operativo corrisponde o è maggiore di, la versione di Windows XP con Service Pack 2 (SP2).
IsWindowsXPSP3OrGreater Indica se la versione corrente del sistema operativo corrisponde o è maggiore di, la versione di Windows XP con Service Pack 3 (SP3).
IsWindowsVistaOrGreater Indica se la versione corrente del sistema operativo corrisponde o è maggiore di, la versione di Windows Vista.
IsWindowsVistaSP1OrGreater Indica se la versione corrente del sistema operativo corrisponde o è maggiore di, la versione di Windows Vista con Service Pack 1 (SP1).
IsWindowsVistaSP2OrGreater Indica se la versione corrente del sistema operativo corrisponde o è maggiore di, la versione di Windows Vista con Service Pack 2 (SP2).
IsWindows7OrGreater Indica se la versione corrente del sistema operativo corrisponde o è maggiore di, la versione di Windows 7.
IsWindows7SP1OrGreater Indica se la versione corrente del sistema operativo corrisponde o è maggiore di, la versione di Windows 7 con Service Pack 1 (SP1).
IsWindows8OrGreater Indica se la versione corrente del sistema operativo corrisponde o è maggiore di, la versione di Windows 8.
IsWindows8Point1OrGreater Indica se la versione corrente del sistema operativo corrisponde o è maggiore di, la versione di Windows 8.1.

Per Windows 10, IsWindows8Point1OrGreater restituisce false a meno che l'applicazione non contenga un manifesto che includa una sezione di compatibilità contenente i GUID che designano Windows 8.1 e/o Windows 10.
IsWindows10OrGreater Indica se la versione corrente del sistema operativo corrisponde o è maggiore di, la versione di Windows 10.

Per Windows 10, IsWindows10OrGreater restituisce false a meno che l'applicazione non contenga un manifesto che include una sezione di compatibilità che contiene il GUID che designa Windows 10.
IsWindowsServer Indica se il sistema operativo corrente è una versione di Windows Server. Le applicazioni che devono distinguere tra le versioni server e client di Windows devono chiamare questa funzione.
IsWindowsVersionOrGreater È consigliabile usare questa funzione solo se le altre funzioni helper della versione fornite non rientrano nello scenario in uso.

Indica se la versione corrente del sistema operativo corrisponde o è maggiore di, le informazioni sulla versione fornite. Questa funzione è utile per confermare una versione di Windows Server che non condivide un numero di versione con una versione client.

Esempio

Le funzioni inline definite nel file di intestazione VersionHelpers.h consentono di verificare la versione del sistema operativo restituendo un valore booleano durante il test di una versione di Windows.

Ad esempio, se l'applicazione richiede Windows 10 o versione successiva, usare il test seguente.

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