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 ela é uma versão do Windows ou do Windows Server. Essas funções fornecem testes simples que usam a função VerifyVersionInfo e as recomendações maiores ou iguais a comparações comprovadas como um meio robusto para determinar a versão do sistema operacional.
Nota
Essas APIs são definidas por versionhelpers.h, que está incluído no SDK (Kit de Desenvolvimento de Software) do Windows 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.
Nota
Versionhelpers.h requer que windows.h sejam incluídos 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 o Windows XP com a versão do Service Pack 1 (SP1). |
| IsWindowsXPSP2OrGreater | Indica se a versão atual do sistema operacional corresponde ou é maior que o Windows XP com a versão do Service Pack 2 (SP2). |
| IsWindowsXPSP3OrGreater | Indica se a versão atual do sistema operacional corresponde ou é maior que o Windows XP com a versão do 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 o Windows 7 com a versão do 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 contém 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ó deverá 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 de booliano ao testar uma versão do Windows.
Por exemplo, se o aplicativo exigir 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);
}