MsiApplyMultiplePatchesA-Funktion (msi.h)

Artikel
08/24/2023

Die MsiApplyMultiplePatches-Funktion wendet einen oder mehrere Patches auf Produkte an, die für den Empfang der Patches berechtigt sind. Die MsiApplyMultiplePatches-Funktion legt die PATCH-Eigenschaft mit einer Liste von Patches fest, die durch Semikolons getrennt sind, und ruft das Patchen der Zielprodukte auf. Andere Eigenschaften können mithilfe einer Eigenschaftenliste festgelegt werden.

Syntax

UINT MsiApplyMultiplePatchesA(
  [in]           LPCSTR szPatchPackages,
  [in, optional] LPCSTR szProductCode,
  [in, optional] LPCSTR szPropertiesList
);

Parameter

[in] szPatchPackages

Eine durch Semikolons getrennte Liste der Pfade zum Patchen von Dateien als einzelne Zeichenfolge. Beispiel: ""c:\sus\download\cache\Office\sp1.msp; c:\sus\download\cache\Office\QFE1.msp; c:\sus\download\cache\Office\QFEn.msp" "

[in, optional] szProductCode

Dieser Parameter ist die ProductCode-GUID des zu patchenden Produkts. Der Benutzer oder die Anwendung, die MsiApplyMultiplePatches aufruft , muss über Berechtigungen zum Anwenden von Patches verfügen. Wenn dieser Parameter NULL ist, werden die Patches auf alle berechtigten Produkte angewendet. Wenn dieser Parameter nicht NULL ist, werden die Patches nur auf das angegebene Produkt angewendet.

[in, optional] szPropertiesList

Eine NULL-endende Zeichenfolge, die Befehlszeileneigenschafteneinstellungen angibt, die beim Patchen von Produkten verwendet werden. Wenn keine Befehlszeileneigenschafteneinstellungen vorhanden sind, übergeben Sie einen NULL-Zeiger . Eine leere Zeichenfolge ist ein ungültiger Parameter. Diese Eigenschaften werden von allen Zielprodukten gemeinsam verwendet. Weitere Informationen finden Sie unter
Informationen zu Eigenschaften und Festlegen öffentlicher Eigenschaftswerte in der Befehlszeile.

Hinweis Die Eigenschaftenliste sollte nicht die PATCH-Eigenschaft enthalten. Wenn die PATCH-Eigenschaft in der Befehlszeile festgelegt ist, wird der Wert ignoriert und mit den angewendeten Patches überschrieben.

Rückgabewert

Die MsiApplyMultiplePatches-Funktion gibt die folgenden Werte zurück.

Wert	Bedeutung
ERROR_INVALID_PARAMETER	Einige übergebene Argumente sind falsch oder widersprechen.
ERROR_SUCCESS	Die Funktion wurde abgeschlossen, und alle Produkte wurden erfolgreich gepatcht. ERROR_SUCCESS wird nur zurückgegeben, wenn alle Produkte, die für die Patches berechtigt sind, erfolgreich gepatcht wurden. Wenn keiner der neuen Patches anwendbar ist, gibt MsiApplyMultiplePatchesERROR_SUCCESS zurück, und der Produktstatus bleibt unverändert.
ERROR_SUCCESS_REBOOT_INITIATED	Der von der letzten Transaktion initiierte Neustart beendete diesen Aufruf von MsiApplyMultiplePatches. Möglicherweise wurden nicht alle Zielprodukte gepatcht.
ERROR_SUCCESS_REBOOT_REQUIRED	Der für die letzte Transaktion erforderliche Neustart beendete diesen Aufruf von MsiApplyMultiplePatches. Möglicherweise wurden nicht alle Zielprodukte gepatcht.
ERROR_PATCH_PACKAGE_OPEN_FAILED	Eines der bereitgestellten Patchpakete konnte nicht geöffnet werden.
ERROR_PATCH_PACKAGE_INVALID	Eines der bereitgestellten Patchpakete ist nicht gültig.
ERROR_PATCH_PACKAGE_UNSUPPORTED	Eines der Patchpakete wird nicht unterstützt.
Beliebiger Fehler in Winerror.h	Impliziert einen möglichen Teilabschluss oder einen Fehler bei einer oder mehreren Transaktionen.

Hinweise

Hinweis

Der msi.h-Header definiert MsiApplyMultiplePatches als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


Unterstützte Mindestversion (Client)	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. Informationen zum minimal erforderlichen Windows Service Pack für eine Windows Installer-Version finden Sie unter Windows Installer – Laufzeitanforderungen.
Zielplattform	Windows
Kopfzeile	msi.h
Bibliothek	Msi.lib
DLL	Msi.dll