Méthode Installer.ProvideQualifiedComponent

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

Syntaxe

Installer.ProvideQualifiedComponent(
  Category,
  Qualifier,
  InstallMode
)

Paramètres

Catégorie

Spécifie l’ID du composant pour le composant demandé. Il peut ne pas s’agir du GUID du composant lui-même, mais plutôt d’un serveur qui fournit les fonctionnalités appropriées, comme dans la colonne ComponentId de la table PublishComponent.

Qualificateur

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

InstallMode

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

InstallMode Signification
msiInstallModeDefault
0
Fournit le composant, en effectuant toute installation nécessaire.
msiInstallModeExisting
–1
Fournit le 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 composant uniquement si la fonctionnalité existe. Autrement, 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 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.

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

MsiProvideQualifiedComponent