MsiEvaluateConditionW, fonction (msiquery.h)

Article
08/25/2023

La fonction MsiEvaluateCondition évalue une expression conditionnelle contenant des noms de propriétés et des valeurs.

Syntaxe

MSICONDITION MsiEvaluateConditionW(
  [in] MSIHANDLE hInstall,
  [in] LPCWSTR   szCondition
);

Paramètres

[in] hInstall

Gérez l’installation fournie à une action personnalisée DLL ou obtenue via MsiOpenPackage, MsiOpenPackageEx ou MsiOpenProduct.

[in] szCondition

Spécifie l’expression conditionnelle. Ce paramètre ne doit pas avoir la valeur NULL. Pour connaître la syntaxe des expressions conditionnelles, consultez Syntaxe de l’instruction conditionnelle.

Valeur retournée

Cette fonction retourne MSICONDITION.

Remarques

Le tableau suivant montre les valeurs d’état des fonctionnalités et des composants utilisées par la fonction MsiEvaluateCondition . Ces états ne sont pas définis tant que MsiSetInstallLevel n’est pas appelé, soit directement, soit par l’action CostFinalize. Par conséquent, la vérification d’état n’est généralement utile que pour les expressions conditionnelles dans une table de séquence d’actions.

Valeur	Signification
INSTALLSTATE_ABSENT	Fonctionnalité ou composant non présent.
INSTALLSTATE_LOCAL	Fonctionnalité ou composant sur l’ordinateur local.
INSTALLSTATE_SOURCE	La fonctionnalité ou le composant s’exécute à partir de la source.
(valeur null)	Aucune action à entreprendre sur la fonctionnalité ou le composant.

Notes

L’en-tête msiquery.h définit MsiEvaluateCondition comme un 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.

Configuration requise

Condition requise	Valeur
Client minimal 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
En-tête	msiquery.h
Bibliothèque	Msi.lib
DLL	Msi.dll

Voir aussi

Fonctions d’action du programme d’installation

Passage de la valeur Null en tant qu’argument des fonctions Windows Installer

Partager via