Fonction VerSetConditionMask (winnt.h)

Article
08/27/2023

Définit les bits d’une valeur 64 bits pour indiquer l’opérateur de comparaison à utiliser pour un attribut de version de système d’exploitation spécifié. Cette fonction est utilisée pour générer le paramètre dwlConditionMask de la fonction VerifyVersionInfo .

Syntaxe

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

Paramètres

[in] ConditionMask

Valeur à passer en tant que paramètre dwlConditionMask de la fonction VerifyVersionInfo . La fonction stocke les informations de comparaison dans les bits de cette variable.

Avant le premier appel à VerSetCondition, initialisez cette variable sur zéro. Pour les appels suivants, transmettez la variable utilisée dans l’appel précédent.

[in] TypeMask

Masque qui indique le membre de la structure OSVERSIONINFOEX dont l’opérateur de comparaison est en cours de définition. Cette valeur correspond à l’un des bits spécifiés dans le paramètre dwTypeMask pour la fonction VerifyVersionInfo . Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
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

Opérateur à utiliser pour la comparaison. La fonction VerifyVersionInfo utilise cet opérateur pour comparer une valeur d’attribut spécifiée à la valeur correspondante pour le système en cours d’exécution.

Pour toutes les valeurs de dwTypeBitMask autres que VER_SUITENAME, ce paramètre peut être l’une des valeurs suivantes.

Valeur	Signification
VER_EQUAL 1	La valeur actuelle doit être égale à la valeur spécifiée.
VER_GREATER 2	La valeur actuelle doit être supérieure à la valeur spécifiée.
VER_GREATER_EQUAL 3	La valeur actuelle doit être supérieure ou égale à la valeur spécifiée.
VER_LESS 4	La valeur actuelle doit être inférieure à la valeur spécifiée.
VER_LESS_EQUAL 5	La valeur actuelle doit être inférieure ou égale à la valeur spécifiée.

Si dwTypeBitMask est VER_SUITENAME, ce paramètre peut être l’une des valeurs suivantes.

Valeur	Signification
VER_AND 6	Toutes les suites de produits spécifiées dans le membre wSuiteMask doivent être présentes dans le système actuel.
VER_OR 7	Au moins une des suites de produits spécifiées doit être présente dans le système actuel.

Valeur retournée

La fonction retourne la valeur du masque de condition.

Remarques

Appelez cette fonction une fois pour chaque jeu de bits dans le paramètre dwTypeMask de la fonction VerifyVersionInfo .

Exemples

Pour obtenir un exemple, consultez Vérification de la version du système.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winnt.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll