MsiConfigureProductA, fonction (msi.h)

  • Article

La fonction MsiConfigureProduct installe ou désinstalle un produit.

Syntaxe

UINT MsiConfigureProductA(
  [in] LPCSTR       szProduct,
  [in] int          iInstallLevel,
  [in] INSTALLSTATE eInstallState
);

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. Le paramètre iInstallLevel est ignoré 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.

Valeur Signification
INSTALLLEVEL_DEFAULT
 Les fonctionnalités par défaut créées sont installées.
INSTALLLEVEL_MINIMUM
 Seules les fonctionnalités requises sont installées. Vous pouvez spécifier une valeur entre INSTALLLEVEL_MINIMUM et INSTALLLEVEL_MAXIMUM pour installer un sous-ensemble de fonctionnalités disponibles.
INSTALLLEVEL_MAXIMUM
 Toutes les fonctionnalités sont installées. Vous pouvez spécifier une valeur entre INSTALLLEVEL_MINIMUM et INSTALLLEVEL_MAXIMUM pour installer un sous-ensemble de fonctionnalités disponibles.

[in] eInstallState

Spécifie l’état d’installation du produit. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
INSTALLSTATE_LOCAL
 Le produit doit être installé avec toutes les fonctionnalités installées localement.
INSTALLSTATE_ABSENT
 Le produit est désinstallé.
INSTALLSTATE_SOURCE
 Le produit doit être installé avec toutes les fonctionnalités installées pour s’exécuter à partir de la source.
INSTALLSTATE_DEFAULT
 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.
INSTALLSTATE_ADVERTISED
 Le produit est publié.

Valeur retournée

Valeur Signification
ERROR_INVALID_PARAMETER
 Un paramètre non valide est passé à la fonction .
ERROR_SUCCESS
 La fonction réussit.
Erreur liée à une action
 Pour plus d’informations, consultez Codes d’erreur.
Erreur d’initialisation
 Erreur liée à l’initialisation.

Remarques

La fonction MsiConfigureProduct affiche l’interface utilisateur à l’aide des paramètres actuels. Les paramètres d’interface utilisateur peuvent être modifiés à l’aide de MsiSetInternalUI, MsiSetExternalUI ou MsiSetExternalUIRecord.

Le paramètre iInstallLevel est ignoré et toutes les fonctionnalités du produit sont installées si le paramètre eInstallState a une valeur autre 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.

Notes

L’en-tête msi.h définit MsiConfigureProduct 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. 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

Voir aussi

Installations à plusieurs packages