MsiConfigureProductExA, fonction (msi.h)

Article
11/20/2024

La fonction MsiConfigureProductEx installe ou désinstalle un produit. Une ligne de commande de produit peut également être spécifiée.

Syntaxe

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

Paramètres

[in] szProduct

Spécifie le code de produit pour le produit à configurer.

[in] iInstallLevel

Spécifie la quantité du produit à installer 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 est défini sur n’importe quelle valeur autre que INSTALLSTATE_DEFAULT.

Ce paramètre peut être l’une des 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 être l’une des 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 latable de fonctionnalités .
INSTALLSTATE_ADVERTISED	Le produit est publié.

[in] szCommandLine

Spécifie les paramètres de propriété de ligne de commande. Il doit s’agir d’une liste du format Property=Setting Property=Setting. Pour plus d’informations, consultez À propos des propriétés.

Valeur de retour

Valeur	Signification
ERROR_INVALID_PARAMETER	Un paramètre non valide est passé à la fonction.
ERROR_SUCCESS	La fonction a réussi.
Une erreur liée à une action	Pour plus d’informations, consultez codes d’erreur.
erreur d’initialisation	Une erreur liée à l’initialisation s’est produite.

Remarques

La ligne de commande transmise en tant que szCommandLine peut contenir l’une des propriétés des options d’installation de fonctionnalités . Dans ce cas, le 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 n’importe quelle autre valeur que INSTALLSTATE_DEFAULT. Pour contrôler l’installation des fonctionnalités individuelles lorsque le paramètre eInstallState n’est pas défini sur INSTALLSTATE_DEFAULT utiliser 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, MsiSetExternalUIou MsiSetExternalUIRecord.

Note

L’en-tête msi.h définit MsiConfigureProductEx 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. Consultez la configuration requise de Windows Installer Run-Time pour plus d’informations sur le service pack Windows minimal requis par une version de Windows Installer.
plateforme cible	Windows
d’en-tête	msi.h
bibliothèque	Msi.lib
DLL	Msi.dll

Voir aussi

messages d’erreur affichés

codes d’erreur

erreur d’initialisation

fonctions d’installation et de configuration

Multiple-Package Installations

Partager via