MsiConfigureFeatureA, fonction (msi.h)

La fonction MsiConfigureFeature configure l’état installé d’une fonctionnalité de produit.

Syntaxe

UINT MsiConfigureFeatureA(
  [in] LPCSTR       szProduct,
  [in] LPCSTR       szFeature,
  [in] INSTALLSTATE eInstallState
);

Paramètres

[in] szProduct

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

[in] szFeature

Spécifie l’ID de fonctionnalité à configurer.

[in] eInstallState

Spécifie l’état d’installation de la fonctionnalité. Ce paramètre doit être l’une des valeurs suivantes.

Valeur Signification
INSTALLSTATE_ADVERTISED
La fonctionnalité est annoncée
INSTALLSTATE_LOCAL
La fonctionnalité est installée localement.
INSTALLSTATE_ABSENT
La fonctionnalité est désinstallée.
INSTALLSTATE_SOURCE
La fonctionnalité est installée pour s’exécuter à partir de la source.
INSTALLSTATE_DEFAULT
La fonctionnalité est installée à son emplacement par défaut.

Valeur de retour

Valeur Signification
ERROR_INVALID_PARAMETER
Un paramètre non valide est passé à la fonction.
ERROR_SUCCESS
La fonction réussit.
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

Note

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