MsiConfigureProductExW, fonction (msi.h)
La fonction MsiConfigureProductEx installe ou désinstalle un produit. Une ligne de commande de produit peut également être spécifiée.
Syntaxe
UINT MsiConfigureProductExW(
[in] LPCWSTR szProduct,
[in] int iInstallLevel,
[in] INSTALLSTATE eInstallState,
[in] LPCWSTR szCommandLine
);
Paramètres
[in] szProduct
Spécifie le code de produit pour le produit à configurer.
[in] iInstallLevel
Spécifie la quantité du produit qui doit être installée lors de l’installation du produit à son état par défaut. Les paramètres iInstallLevel sont ignorés et toutes les fonctionnalités sont installées si le paramètre eInstallState a une valeur autre que INSTALLSTATE_DEFAULT.
Ce paramètre peut prendre les valeurs suivantes.
[in] eInstallState
Spécifie l’état d’installation du produit. Ce paramètre peut prendre les valeurs suivantes.
Valeur | Signification |
---|---|
|
Le produit doit être installé avec toutes les fonctionnalités installées localement. |
|
Le produit est désinstallé. |
|
Le produit doit être installé avec toutes les fonctionnalités installées pour s’exécuter à partir de la source. |
|
Le produit doit être installé avec toutes les fonctionnalités installées aux états par défaut spécifiés dans la table des fonctionnalités. |
|
Le produit est publié. |
[in] szCommandLine
Spécifie les paramètres de la propriété de ligne de commande. Il doit s’agir d’une liste du format Property=Setting Property=Setting. Pour plus d’informations, voir Questions fréquentes sur les propriétés.
Valeur retournée
Valeur | Signification |
---|---|
|
Un paramètre non valide est passé à la fonction . |
|
La fonction a réussi. |
|
Pour plus d’informations, consultez Codes d’erreur. |
Une erreur relative à l’initialisation s’est produite. |
Remarques
La ligne de commande passée en tant que szCommandLine peut contenir n’importe quelle propriété des options d’installation de fonctionnalité. Dans ce cas, l’eInstallState passé doit être INSTALLSTATE_DEFAULT.
Le paramètre iInstallLevel est ignoré et toutes les fonctionnalités du produit sont installées si le paramètre eInstallState est défini sur une autre valeur que INSTALLSTATE_DEFAULT. Pour contrôler l’installation de fonctionnalités individuelles lorsque le paramètre eInstallState n’est pas défini sur INSTALLSTATE_DEFAULT utilisez MsiConfigureFeature.
La fonction MsiConfigureProductEx affiche l’interface utilisateur à l’aide des paramètres actuels. Les paramètres d’interface utilisateur peuvent être modifiés avec MsiSetInternalUI, MsiSetExternalUI ou MsiSetExternalUIRecord.
Notes
L’en-tête msi.h définit MsiConfigureProductEx 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. Pour plus d’informations sur le Service Pack Windows requis par une version de Windows Installer, consultez Configuration requise pour le runtime Windows. |
Plateforme cible | Windows |
En-tête | msi.h |
Bibliothèque | Msi.lib |
DLL | Msi.dll |