Installer.ProvideQualifiedComponent-Methode

Artikel
06/13/2023

Die ProvideQualifiedComponent-Methode des Installer-Objekts gibt den vollständigen Komponentenpfad zurück und führt alle erforderlichen Installationen aus. Bei Bedarf fordert diese Methode zur Eingabe der Quelle auf und erhöht die Verwendungsanzahl für das Feature.

Syntax

Installer.ProvideQualifiedComponent(
  Category,
  Qualifier,
  InstallMode
)

Parameter

Kategorie

Gibt die Komponenten-ID für die angeforderte Komponente an. Hierbei handelt es sich möglicherweise nicht um die GUID für die Komponente selbst, sondern um einen Server, der entsprechend der Spalte „ComponentId“ der PublishComponent-Tabelle die richtige Funktionalität bereitstellt.

Qualifizierer

Gibt einen Qualifizierer für eine Liste von angekündigten Komponenten an (aus der PublishComponent-Tabelle).

InstallMode

Definiert den Installationsmodus. Für diesen Parameter kann einer der Werte in der folgenden Tabelle angegeben werden.

InstallMode	Bedeutung
msiInstallModeDefault 0	Stellt die Komponente bereit, indem alle erforderlichen Installationen durchgeführt werden.
msiInstallModeExisting –1	Stellt die Komponente nur bereit, wenn das Feature vorhanden ist. Gibt andernfalls eine leere Zeichenfolge zurück. In diesem Modus wird überprüft, ob die Schlüsseldatei der Komponente vorhanden ist.
msiInstallModeNoDetection –2	Stellt die Komponente nur bereit, wenn das Feature vorhanden ist. Gibt andernfalls eine leere Zeichenfolge zurück. Dieser Modus überprüft nur, ob die Komponente registriert ist, jedoch nicht, ob die Schlüsseldatei der Komponente vorhanden ist.
msiInstallModeNoSourceResolution –3	Stellt den Komponentenpfad nur bereit, wenn das Feature mit dem InstallState-Parameter msiInstallStateLocal vorhanden ist. Überprüft wird die Registrierung der Komponente, jedoch nicht, ob die Schlüsseldatei der Komponente vorhanden ist.
Kombination der msiReinstallMode-Flags	Ruft ReinstallFeature auf, um das Feature mithilfe dieses Parameters für den ReinstallMode-Parameter neu zu installieren, und stellt dann die Komponente bereit.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Anforderungen

Anforderung	Wert
Version	Windows Installer 5.0 unter Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 unter Windows Server 2008 oder Windows Vista. Windows Installer unter Windows Server 2003 oder Windows XP
DLL	Msi.dll
IID	IID_IInstaller ist definiert als 000C1090-0000-0000-C000-000000000046

Siehe auch

MsiProvideQualifiedComponent

Freigeben über