Funções auxiliares de versão

  • Artigo

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);
}