Installer.ApplyPatch-Methode

Artikel
06/13/2023

Die ApplyPatch-Methode des Installer-Objekts ruft für jedes im Patchpaket aufgeführte Produkt, das für den Patch infrage kommt, eine Installation auf und setzt die PATCH-Eigenschaft auf den Pfad des Patchpakets.

Syntax

Installer.ApplyPatch(
  PatchPackage,
  InstallPackage,
  InstallType,
  CommandLine
)

Parameter

PatchPackage

Gibt einen Pfad zum Patchpaket an.

InstallPackage

Wenn InstallType auf msiInstallTypeNetworkImage festgelegt ist, gibt InstallPackage den Pfad zu dem Produkt an, das gepatcht werden soll. Wenn InstallType auf msiInstallTypeDefault und InstallPackage auf 0 festgelegt ist, wendet der Installer den Patch auf jedes berechtigte Produkt an, das im Patchpaket aufgeführt ist.

Wenn InstallType auf msiInstallTypeSingleInstance festgelegt ist, wendet der Installer den Patch auf das durch InstallPackage angegebene Produkt an. In diesem Fall werden andere berechtigte Produkte, die im Patchpaket aufgeführt sind, ignoriert, und der InstallPackage-Parameter enthält die NULL-terminierte Zeichenfolge, die den Produktcode der zu patchenden Instanz darstellt. Für diese Art der Installation ist die Windows Installer-Version erforderlich, die mit Windows Server 2003 oder höher oder Windows Installer XP SP1 oder höher geliefert wird.

InstallType

Dieser Parameter gibt den Typ der zu patchenden Installation an. Der InstallType-Parameter wird ignoriert, wenn InstallPackage ausgelassen wird.

Wert	Bedeutung
msiInstallTypeNetworkImage	Gibt eine Administratorinstallation an. In diesem Fall muss InstallPackage auf einen Paketpfad festgelegt werden. Der Wert 1 für msiInstallTypeNetworkImage gibt eine Administratorinstallation an.
msiInstallTypeDefault	Durchsucht das System nach zu patchenden Produkten. In diesem Fall muss InstallPackage eine leere Zeichenfolge sein.
msiInstallSingleInstance	Patcht das durch InstallPackage angegebene Produkt. InstallPackage ist der Produktcode der zu patchenden Instanz. Für diese Art der Installation ist die Windows Installer-Version erforderlich, die mit Windows Server 2003 oder höher oder Windows Installer XP SP1 oder höher geliefert wird. Weitere Informationen finden Sie unter Installieren mehrerer Instanzen von Produkten und Patches.

CommandLine

Gibt Eigenschafteneinstellungen an, die über die Befehlszeile festgelegt werden. Weitere Informationen finden Sie im Abschnitt mit den Hinweisen.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Da das Listentrennzeichen für Transformationen, Quellen und Patches ein Semikolon ist, sollte dieses Zeichen nicht für Dateinamen oder Pfade verwendet werden.

Die REINSTALL-Eigenschaft ist erforderlich, wenn ein kleiner Update- oder ein kleiner Upgrade-Patch angewendet wird. Ohne diese Eigenschaft wird der Patch auf dem System registriert, kann jedoch keine Dateien aktualisieren.

Windows Installer 2.0: Sie müssen die REINSTALL-Eigenschaft in der Befehlszeile festlegen, wenn Sie einen kleinen Update- oder einen kleinen Upgrade-Patch anwenden. Für Patches, die keinen benutzerdefinierten Aktionstyp 51 zum automatischen Festlegen der Eigenschaften REINSTALL und REINSTALLMODE verwenden, muss die REINSTALL-Eigenschaft explizit mit dem CommandLine-Parameter festgelegt werden. Legen Sie die REINSTALL-Eigenschaft fest, um die vom Patch betroffenen Features aufzulisten, oder verwenden Sie die praktische Standardeinstellung „REINSTALL=ALL“. Der Standardwert der REINSTALLMODE-Eigenschaft lautet „omus“.

Windows Installer 3.0 und höher: Ab Windows Installer Version 3.0 wird die REINSTALL-Eigenschaft vom Installer konfiguriert und muss nicht über die Befehlszeile festgelegt 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 3.0 oder höher unter Windows Server 2003 oder Windows XP.
DLL	Msi.dll
IID	IID_IInstaller ist definiert als 000C1090-0000-0000-C000-000000000046

Siehe auch

MsiApplyPatch
Informationen zu Eigenschaften
Von Windows Installer 2.0 und früheren Versionen nicht unterstützt

Share via