MsiInstallMissingComponentA, fonction (msi.h)

  • Article

La fonction MsiInstallMissingComponent installe les fichiers manquants de manière inattendue.

Syntaxe

UINT MsiInstallMissingComponentA(
  [in] LPCSTR       szProduct,
  [in] LPCSTR       szComponent,
  [in] INSTALLSTATE eInstallState
);

Paramètres

[in] szProduct

Spécifie le code de produit pour le produit propriétaire du composant à installer.

[in] szComponent

Identifie le composant à installer.

[in] eInstallState

Spécifie la façon dont le composant doit être installé. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
INSTALLSTATE_LOCAL
 Le composant doit être installé localement.
INSTALLSTATE_SOURCE
 Le composant doit être installé pour s’exécuter à partir de la source.
INSTALLSTATE_DEFAULT
 Le composant doit être installé en fonction des valeurs par défaut du programme d’installation.

Valeur retournée

Valeur Signification
ERROR_BAD_CONFIGURATION
 Les informations de configuration sont endommagées.
ERROR_INSTALL_FAILURE
 L'installation a échoué.
ERROR_INSTALL_SOURCE_ABSENT
 La source n’était pas disponible.
ERROR_INSTALL_SUSPEND
 L’installation a été suspendue.
ERROR_INSTALL_USEREXIT
 L’utilisateur a quitté l’installation.
ERROR_INVALID_PARAMETER
 L’un des paramètres n’est pas valide.
ERROR_SUCCESS
 La fonction s’est terminée avec succès.
ERROR_UNKNOWN_PRODUCT
 Le code produit n’est pas reconnu.
 

Pour plus d’informations sur les messages d’erreur, consultez Messages d’erreur affichés.

Remarques

La fonction MsiInstallMissingComponent résout la ou les fonctionnalités auxquelles appartient le composant. Ensuite, la fonctionnalité de produit qui nécessite le moins d’espace disque supplémentaire est installée.

Notes

L’en-tête msi.h définit MsiInstallMissingComponent en tant qu’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. La combinaison 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