Estrutura OSVERSIONINFOEXA (winnt.h)

Contém informações de versão do sistema operacional. As informações incluem números de versão principal e secundária, um número de build, um identificador de plataforma e informações sobre pacotes de produtos e o Service Pack mais recente instalado no sistema. Essa estrutura é usada com as funções GetVersionEx e VerifyVersionInfo .

Sintaxe

typedef struct _OSVERSIONINFOEXA {
  DWORD dwOSVersionInfoSize;
  DWORD dwMajorVersion;
  DWORD dwMinorVersion;
  DWORD dwBuildNumber;
  DWORD dwPlatformId;
  CHAR  szCSDVersion[128];
  WORD  wServicePackMajor;
  WORD  wServicePackMinor;
  WORD  wSuiteMask;
  BYTE  wProductType;
  BYTE  wReserved;
} OSVERSIONINFOEXA, *POSVERSIONINFOEXA, *LPOSVERSIONINFOEXA;

Membros

dwOSVersionInfoSize

O tamanho dessa estrutura de dados, em bytes. Defina esse membro como sizeof(OSVERSIONINFOEX).

dwMajorVersion

O número de versão principal do sistema operacional. Para obter mais informações, consulte Comentários.

dwMinorVersion

O número de versão secundária do sistema operacional. Para obter mais informações, consulte Comentários.

dwBuildNumber

O número de build do sistema operacional.

dwPlatformId

A plataforma do sistema operacional. Esse membro pode ser VER_PLATFORM_WIN32_NT (2).

szCSDVersion[128]

Uma cadeia de caracteres terminada em nulo, como "Service Pack 3", que indica o Service Pack mais recente instalado no sistema. Se nenhum Service Pack tiver sido instalado, a cadeia de caracteres estará vazia.

wServicePackMajor

O número de versão principal do Service Pack mais recente instalado no sistema. Por exemplo, para o Service Pack 3, o número da versão principal é 3. Se nenhum Service Pack tiver sido instalado, o valor será zero.

wServicePackMinor

O número de versão secundária do Service Pack mais recente instalado no sistema. Por exemplo, para Service Pack 3, o número de versão secundária é 0.

wSuiteMask

Uma máscara de bits que identifica os pacotes de produtos disponíveis no sistema. Esse membro pode ser uma combinação dos valores a seguir.

wProductType

Qualquer informação adicional sobre o sistema. Esse membro pode ser um dos valores a seguir.

wReserved

Reservado para uso futuro.

Comentários

Confiar em informações de versão não é a melhor maneira de testar um recurso. Em vez disso, consulte a documentação do recurso de interesse. Para obter mais informações sobre técnicas comuns para detecção de recursos, consulte Versão do sistema operacional.

Se você precisar de um sistema operacional específico, use-o como uma versão mínima com suporte, em vez de projetar o teste para um sistema operacional. Dessa forma, seu código de detecção continuará funcionando em versões futuras do Windows.

A tabela a seguir resume os valores retornados por versões com suporte do Windows. Use as informações na coluna rotulada como "Outros" para distinguir entre sistemas operacionais com números de versão idênticos.

Você não deve contar apenas com o sinalizador VER_SUITE_SMALLBUSINESS para determinar se o Small Business Server foi instalado no sistema, pois esse sinalizador e o sinalizador VER_SUITE_SMALLBUSINESS_RESTRICTED são definidos quando este pacote de produtos é instalado. Se você atualizar essa instalação para o Windows Server, Standard Edition, o sinalizador VER_SUITE_SMALLBUSINESS_RESTRICTED será limpo. No entanto, o sinalizador VER_SUITE_SMALLBUSINESS permanecerá definido. Nesse caso, isso indica que o Small Business Server já foi instalado nesse sistema. Se essa instalação for atualizada para o Windows Server, Edição Enterprise, o sinalizador VER_SUITE_SMALLBUSINESS permanecerá definido.

Se o modo de compatibilidade estiver em vigor, a estrutura OSVERSIONINFOEX conterá informações sobre o sistema operacional selecionado para compatibilidade do aplicativo.

Para determinar se um aplicativo baseado em Win32 está em execução no WOW64, chame a função IsWow64Process . Para determinar se o sistema está executando uma versão de 64 bits do Windows, chame a função GetNativeSystemInfo .

A função GetSystemMetrics fornece as seguintes informações adicionais sobre o sistema operacional atual.

Exemplos

Para obter um exemplo, consulte Obtendo a versão do sistema.

Requisitos

Confira também

IsWow64Process

OSVERSIONINFO

APIs auxiliares de versão