Função VerSetConditionMask (winnt.h)

  • Artigo

Define os bits de um valor de 64 bits para indicar o operador de comparação a ser usado para um atributo de versão do sistema operacional especificado. Essa função é usada para criar o parâmetro dwlConditionMask da função VerifyVersionInfo .

Sintaxe

NTSYSAPI ULONGLONG VerSetConditionMask(
  [in] ULONGLONG ConditionMask,
  [in] DWORD     TypeMask,
  [in] BYTE      Condition
);

Parâmetros

[in] ConditionMask

Um valor a ser passado como o parâmetro dwlConditionMask da função VerifyVersionInfo . A função armazena as informações de comparação nos bits dessa variável.

Antes da primeira chamada para VerSetCondition, inicialize essa variável como zero. Para chamadas subsequentes, passe a variável usada na chamada anterior.

[in] TypeMask

Uma máscara que indica o membro da estrutura OSVERSIONINFOEX cujo operador de comparação está sendo definido. Esse valor corresponde a um dos bits especificados no parâmetro dwTypeMask para a função VerifyVersionInfo . Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
VER_BUILDNUMBER
0x0000004
 dwBuildNumber
VER_MAJORVERSION
0x0000002
 dwMajorVersion
VER_MINORVERSION
0x0000001
 dwMinorVersion
VER_PLATFORMID
0x0000008
 dwPlatformId
VER_PRODUCT_TYPE
0x0000080
 wProductType
VER_SERVICEPACKMAJOR
0x0000020
 wServicePackMajor
VER_SERVICEPACKMINOR
0x0000010
 wServicePackMinor
VER_SUITENAME
0x0000040
 wSuiteMask

[in] Condition

O operador a ser usado para a comparação. A função VerifyVersionInfo usa esse operador para comparar um valor de atributo especificado com o valor correspondente para o sistema em execução no momento.

Para todos os valores de dwTypeBitMask diferentes de VER_SUITENAME, esse parâmetro pode ser um dos valores a seguir.

Valor Significado
VER_EQUAL
1
 O valor atual deve ser igual ao valor especificado.
VER_GREATER
2
 O valor atual deve ser maior que o valor especificado.
VER_GREATER_EQUAL
3
 O valor atual deve ser maior ou igual ao valor especificado.
VER_LESS
4
 O valor atual deve ser menor que o valor especificado.
VER_LESS_EQUAL
5
 O valor atual deve ser menor ou igual ao valor especificado.
 

Se dwTypeBitMask for VER_SUITENAME, esse parâmetro poderá ser um dos valores a seguir.

Valor Significado
VER_AND
6
 Todos os pacotes de produtos especificados no membro wSuiteMask devem estar presentes no sistema atual.
VER_OR
7
 Pelo menos um dos pacotes de produtos especificados deve estar presente no sistema atual.

Retornar valor

A função retorna o valor da máscara de condição.

Comentários

Chame essa função uma vez para cada conjunto de bits no parâmetro dwTypeMask da função VerifyVersionInfo .

Exemplos

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winnt.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

OSVERSIONINFOEX

Versão do sistema operacional

Funções de informações do sistema

VerifyVersionInfo