Méthode Installer.ProvideComponent

Article
06/13/2023

La méthode ProvideComponent de l’objet Installer retourne le chemin d’accès complet du composant et effectue l’installation nécessaire. Si nécessaire, la méthode ProvideComponent de l’objet Installer invite à entrer la source et incrémente le nombre d’utilisations de la fonctionnalité.

Syntaxe

Installer.ProvideComponent(
  Product,
  Feature,
  Component,
  InstallMode
)

Paramètres

Produit

Spécifie le code du produit.

Fonctionnalité

Spécifie l’ID de fonctionnalité de la fonctionnalité contenant le composant.

Composant

Spécifie le code du composant.

InstallMode

Définit le mode d’installation. Ce paramètre peut correspondre à l’une des valeurs présentées dans la table ci-dessous.

Nom	Signification
msiInstallModeDefault 0	Fournit le chemin d’accès du composant, en effectuant n’importe quelle installation, si nécessaire.
msiInstallModeExisting –1	Fournit le chemin d’accès du composant uniquement si la fonctionnalité existe. Autrement, retourne une chaîne vide. Ce mode vérifie l’existence du fichier de clé du composant.
msiInstallModeNoDetection –2	Fournit le chemin d’accès du composant uniquement si la fonctionnalité existe. Autrement, la fonction retourne une chaîne vide. Ce mode vérifie l’inscription du composant, mais ne vérifie pas l’existence du fichier de clé du composant.
msiInstallModeNoSourceResolution –3	Fournit le chemin d’accès du composant uniquement si la fonctionnalité existe avec un paramètre InstallState msiInstallStateLocal. Cela permet de vérifier l’inscription du composant, mais ne vérifie pas l’existence du fichier de clé du composant.
combinaison des indicateurs msiReinstallMode	Appelle ReinstallFeature pour réinstaller la fonctionnalité à l’aide de ce paramètre pour le paramètre ReinstallMode, puis fournit le composant.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

La méthode ProvideComponent combine les fonctionnalités UseFeature, ConfigureFeature et ComponentPath. La méthode ProvideComponent simplifie la séquence d’appel, mais elle incrémente également le nombre d’utilisations et doit être utilisée avec précaution pour éviter des nombres d’utilisations incorrects. La méthode ProvideComponent offre également moins de flexibilité qu’une série d’appels individuels aux méthodes et propriétés mentionnées précédemment.

Si l’application se remet d’une situation inattendue, l’application a probablement déjà appelé UseFeature et incrémenté le nombre d’utilisations. Dans ce cas, l’application doit éviter d’incrémenter le nombre d’utilisations en appelant la méthode ConfigureFeature au lieu de la méthode ProvideComponent.

L’option msiInstallModeExisting ne peut pas être utilisée en combinaison avec les indicateurs msiReinstallMode.

Configuration requise

Condition requise	Valeur
Version	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
DLL	Msi.dll
IID	IID_IInstaller est défini comme 000C1090-0000-0000-C000-000000000046

Voir aussi

MsiProvideComponent