MsiApplyMultiplePatchesA-Funktion (msi.h)

Artikel
11/20/2024

Die MsiApplyMultiplePatches--Funktion wendet mindestens ein Patche 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, der 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 nichtNULL-ist, werden die Patches nur auf das angegebene Produkt angewendet.

[in, optional] szPropertiesList

Eine mit Null beendete Zeichenfolge, die Befehlszeileneigenschafteneinstellungen angibt, die während des Patchings 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 eigenschaft PATCH enthalten. Wenn die PATCH--Eigenschaft in der Befehlszeile festgelegt wird, 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 widersprechend.
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 werden. Wenn keines der neuen Patches anwendbar ist, bleibt MsiApplyMultiplePatchesERROR_SUCCESS zurück, und der Produktstatus bleibt unverändert.
ERROR_SUCCESS_REBOOT_INITIATED	Der von der letzten Transaktion initiierte Neustart beendet diesen Aufruf an MsiApplyMultiplePatches. Möglicherweise wurden nicht alle Zielprodukte gepatcht.
ERROR_SUCCESS_REBOOT_REQUIRED	Der neustart, der von der letzten Transaktion erforderlich ist, beendet diesen Aufruf an 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 kein gültiger Paket.
ERROR_PATCH_PACKAGE_UNSUPPORTED	Eines der Patchpakete wird nicht unterstützt.
Alle Fehler in Winerror.h	Impliziert eine mögliche teilweise Fertigstellung oder dass mindestens eine Transaktion fehlgeschlagen ist.

Bemerkungen

Anmerkung

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

Anforderung	Wert
mindestens unterstützte 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 mindestens von einer Windows Installer-Version erforderlichen Windows-Service Pack finden Sie unter den Windows Installer-Run-Time Anforderungen.
Zielplattform-	Fenster
Header-	msi.h
Library	Msi.lib
DLL-	Msi.dll