MsiEvaluateConditionA, fonction (msiquery.h)
La fonction MsiEvaluateCondition évalue une expression conditionnelle contenant des noms de propriétés et des valeurs.
Syntaxe
MSICONDITION MsiEvaluateConditionA(
[in] MSIHANDLE hInstall,
[in] LPCSTR szCondition
);
Paramètres
[in] hInstall
Gérez l’installation fournie à une action personnalisée DLL ou obtenue via msiOpenPackage, MsiOpenPackageExou MsiOpenProduct.
[in] szCondition
Spécifie l’expression conditionnelle. Ce paramètre ne doit pas être NULL. Pour connaître la syntaxe des expressions conditionnelles, consultez syntaxe d’instruction conditionnelle.
Valeur de retour
Cette fonction retourne MSICONDITION.
Remarques
Le tableau suivant présente les valeurs d’état de composant et de fonctionnalité utilisées par la fonction MsiEvaluateCondition. Ces états ne sont pas définis tant que MsiSetInstallLevel est appelé, directement ou par l’action CostFinalize. Par conséquent, la vérification de l’état est généralement utile uniquement pour les expressions conditionnelles dans une table de séquences d’actions.
Valeur | Signification |
---|---|
INSTALLSTATE_ABSENT | Fonctionnalité ou composant non présent. |
INSTALLSTATE_LOCAL | Fonctionnalité ou composant sur l’ordinateur local. |
INSTALLSTATE_SOURCE | Fonctionnalité ou composant exécuté à partir de la source. |
(valeur null) | Aucune action à entreprendre sur la fonctionnalité ou le composant. |
Note
L’en-tête msiquery.h définit MsiEvaluateCondition comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
Exigence | Valeur |
---|---|
client minimum pris en charge | Windows Installer 5.0 sur Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 sur Windows Server 2008 ou Windows Vista. Windows Installer sur Windows Server 2003 ou Windows XP |
plateforme cible | Windows |
d’en-tête | msiquery.h |
bibliothèque | Msi.lib |
DLL | Msi.dll |
Voir aussi
Fonctions d’action du programme d’installation
passage de null en tant qu’argument des fonctions Windows Installer