Installer. ProvideQualifiedComponent, méthode

La méthode ProvideQualifiedComponent de l’objet installer retourne le chemin d’accès complet au composant et effectue toute installation nécessaire. Si nécessaire, cette méthode vous invite à entrer la source et incrémente le nombre d’utilisations de la fonctionnalité.

Syntaxe

Installer.ProvideQualifiedComponent(
  Category,
  Qualifier,
  InstallMode
)

Paramètres

Catégorie

Spécifie l’ID de composant pour le composant demandé. Ce n’est peut-être pas le GUID du composant lui-même, mais plutôt un serveur qui fournit les fonctionnalités correctes, comme dans la colonne ComponentId de la table PublishComponent.

Qualificateur

Spécifie un qualificateur dans une liste de composants de publicité (à partir de la table PublishComponent).

InstallMode

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

InstallMode Signification
msiInstallModeDefault
0
Fournit le composant, en effectuant toutes les installations nécessaires.
msiInstallModeExisting
– 1
Fournit le 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 composant uniquement si la fonctionnalité existe ; Sinon, retourne une chaîne vide. Ce mode vérifie uniquement que le composant est inscrit, 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.

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

MsiProvideQualifiedComponent