Funções auxiliares de versão
As funções a seguir podem ser usadas para determinar a versão atual do sistema operacional ou identificar se é uma versão do Windows ou do Windows Server. Essas funções fornecem testes simples que usam a função VerifyVersionInfo e o recomendado maior ou igual a comparações que são comprovadas como um meio robusto para determinar a versão do sistema operacional.
Observação
Essas APIs são definidas por versionhelpers.h, que está incluído no Windows Software Development Kit (SDK) para Windows 8.1 e posterior. Esse arquivo pode ser usado com outras versões do Microsoft Visual Studio para implementar a mesma funcionalidade para versões do Windows anteriores ao Windows 8.1.
Observação
Versionhelpers.h requer windows.h para ser incluído antes dele.
| Função | Descrição |
|---|---|
| IsWindowsXPOrGreater | Indica se a versão atual do sistema operacional corresponde ou é maior que a versão do Windows XP. |
| IsWindowsXPSP1OrGreater | Indica se a versão atual do sistema operacional corresponde ou é maior que a versão do Windows XP com Service Pack 1 (SP1). |
| IsWindowsXPSP2OrGreater | Indica se a versão atual do sistema operacional corresponde ou é maior que a versão do Windows XP com Service Pack 2 (SP2). |
| IsWindowsXPSP3OrGreater | Indica se a versão atual do sistema operacional corresponde ou é maior que a versão do Windows XP com Service Pack 3 (SP3). |
| IsWindowsVistaOrGreater | Indica se a versão atual do sistema operacional corresponde ou é maior que a versão do Windows Vista. |
| IsWindowsVistaSP1OrGreater | Indica se a versão atual do sistema operacional corresponde ou é maior que a versão do Windows Vista com Service Pack 1 (SP1). |
| IsWindowsVistaSP2OrGreater | Indica se a versão atual do sistema operacional corresponde ou é maior que a versão do Windows Vista com Service Pack 2 (SP2). |
| IsWindows7OrGreater | Indica se a versão atual do sistema operacional corresponde ou é maior que a versão do Windows 7. |
| IsWindows7SP1OrGreater | Indica se a versão atual do sistema operacional corresponde ou é maior que a versão do Windows 7 com Service Pack 1 (SP1). |
| IsWindows8OrGreater | Indica se a versão atual do sistema operacional corresponde ou é maior que a versão do Windows 8. |
| IsWindows8Point1OrGreater | Indica se a versão atual do sistema operacional corresponde ou é maior que a versão do Windows 8.1. Para o Windows 10, IsWindows8Point1OrGreater retorna false a menos que o aplicativo contenha um manifesto que inclua uma seção de compatibilidade que contenha os GUIDs que designam o Windows 8.1 e/ou o Windows 10. |
| IsWindows10OrGreater | Indica se a versão atual do sistema operacional corresponde ou é maior que a versão do Windows 10. Para o Windows 10, IsWindows10OrGreater retorna false a menos que o aplicativo contenha um manifesto que inclua uma seção de compatibilidade que contenha o GUID que designa o Windows 10. |
| IsWindowsServer | Indica se o sistema operacional atual é uma versão do Windows Server. Os aplicativos que precisam distinguir entre as versões de servidor e cliente do Windows devem chamar essa função. |
| IsWindowsVersionOrGreater | Você só deve usar essa função se as outras funções auxiliares de versão fornecidas não se ajustarem ao seu cenário. Indica se a versão atual do sistema operacional corresponde ou é maior que as informações de versão fornecidas. Essa função é útil para confirmar uma versão do Windows Server que não compartilha um número de versão com uma versão do cliente. |
Exemplo
As funções embutidas definidas no arquivo de cabeçalho VersionHelpers.h permitem verificar a versão do sistema operacional retornando um valor booleano ao testar uma versão do Windows.
Por exemplo, se seu aplicativo requer o Windows 10 ou posterior, use o teste a seguir.
#include <windows.h>
#include <VersionHelpers.h>
if (!IsWindows10OrGreater())
{
MessageBox(NULL, "You need at least Windows 10", "Version Not Supported", MB_OK);
}