Installer.ProvideComponent-Methode

Artikel
06/13/2023

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

Syntax

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

Parameter

Produkt

Gibt den Produktcode des Produkts an.

Feature

Gibt die Feature-ID des Features an, das die Komponente enthält.

Komponente

Gibt den Komponentencode an.

InstallMode

Definiert den Installationsmodus. Für diesen Parameter ist nur einer der Werte in der folgenden Tabelle gültig.

Name	Bedeutung
msiInstallModeDefault 0	Stellt den Komponentenpfad bereit und führt bei Bedarf notwendige Installationen durch.
msiInstallModeExisting –1	Stellt den Komponentenpfad 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 den Komponentenpfad nur bereit, wenn das Feature vorhanden ist. Andernfalls wird eine leere Zeichenfolge zurückgegeben. Dieser Modus überprüft zwar die Registrierung der Komponente, 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.

Bemerkungen

Die ProvideComponent-Methode kombiniert die Funktionalität von UseFeature, ConfigureFeature und ComponentPath. Die ProvideComponent-Methode vereinfacht die Aufrufsequenz, erhöht aber auch die Verwendungsanzahl. Sie sollte daher mit Bedacht verwendet werden, um eine ungenaue Verwendungsanzahl zu verhindern. Die ProvideComponent-Methode bietet auch weniger Flexibilität als eine Reihe einzelner Aufrufe der zuvor genannten Methoden und Eigenschaften.

Wenn die Anwendung nach einer unerwarteten Situation wiederhergestellt wird, hat die Anwendung wahrscheinlich bereits UseFeature aufgerufen und die Verwendungsanzahl erhöht. In diesem Fall sollte vermieden werden, dass die Anwendung die Verwendungsanzahl erhöht, indem anstelle der ProvideComponent-Methode die ConfigureFeature-Methode aufgerufen wird .

Die „MsiInstallModeExisting“-Option kann nicht in Kombination mit „msiReinstallMode“-Flags verwendet werden.

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

MsiProvideComponent

Freigeben über