Installer. ProvideComponent, méthode

La méthode ProvideComponent de l’objet installer retourne le chemin d’accès complet au composant et effectue toute installation nécessaire. Si nécessaire, la méthode ProvideComponent de l’objet installer demande 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 de produit du produit.

Fonctionnalité

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

Composant

Spécifie le code du composant.

InstallMode

Définit le mode d’installation. Ce paramètre peut avoir l’une des valeurs indiquées dans le tableau suivant.

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 ; Sinon, 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. Sinon, 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 de msiInstallStateLocal. Cela vérifie 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 de retour

Cette méthode ne retourne pas de valeur.

Notes

La méthode ProvideComponent combine les fonctionnalités de UseFeature, ConfigureFeatureet ComponentPath. La méthode ProvideComponent simplifie la séquence d’appel, mais incrémente également le nombre d’utilisations et doit être utilisée avec précaution afin d’éviter des nombres d’utilisations inexacts. 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 est en cours de récupération à la suite 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 association avec les indicateurs msiReinstallMode.

Spécifications

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 en tant que 000C1090-0000-0000-C000-000000000046

Voir aussi

MsiProvideComponent