MsiRemovePatchesW-Funktion (msi.h)

Artikel
11/20/2024

Die MsiRemovePatches Funktion entfernt mindestens ein Patche aus einem einzelnen Produkt. Um einen Patch aus mehreren Produkten zu entfernen, müssen MsiRemovePatches- für jedes Produkt aufgerufen werden.

Syntax

UINT MsiRemovePatchesW(
  [in]           LPCWSTR     szPatchList,
  [in]           LPCWSTR     szProductCode,
  [in]           INSTALLTYPE eUninstallType,
  [in, optional] LPCWSTR     szPropertyList
);

Parameter

[in] szPatchList

Eine mit Null beendete Zeichenfolge, die die Liste der zu entfernenden Patches darstellt. Jeder Patch kann durch die GUID des Patches oder den vollständigen Pfad zum Patchpaket angegeben werden. Die Patches in der Liste sind durch Semikolons getrennt.

[in] szProductCode

Eine mit Null beendete Zeichenfolge, die die ProductCode- (GUID) des Produkts ist, aus dem die Patches entfernt werden. Dieser Parameter kann nicht NULL-werden.

[in] eUninstallType

Wert, der den Typ der auszuführenden Patchentfernung angibt. Dieser Parameter muss INSTALLTYPE_SINGLE_INSTANCEwerden.

Wert	Bedeutung
INSTALLTYPE_SINGLE_INSTANCE	Der Patch wird nur für das von szProductangegebene Produkt deinstalliert.

[in, optional] szPropertyList

Eine mit Null beendete Zeichenfolge, die Befehlszeileneigenschafteneinstellungen angibt. Weitere Informationen finden Sie unter
Informationen zu Eigenschaften und Festlegen öffentlicher Eigenschaftswerte in der Befehlszeile. Dieser Parameter kann NULL-sein.

Rückgabewert

Die MsiRemovePatches Funktion gibt die folgenden Werte zurück.

Wert	Bedeutung
ERROR_INVALID_PARAMETER	Ein ungültiger Parameter wurde eingeschlossen.
ERROR_PATCH_PACKAGE_OPEN_FAILED	Das Patchpaket konnte nicht geöffnet werden.
ERROR_SUCCESS	Der Patch wurde erfolgreich entfernt.
ERROR_UNKNOWN_PRODUCT	Das durch szProductList angegebene Produkt wird nicht pro Computer oder pro Benutzer für den Aufrufer von MsiRemovePatchesinstalliert.
ERROR_PATCH_PACKAGE_OPEN_FAILED	Das Patchpaket konnte nicht geöffnet werden.
ERROR_PATCH_PACKAGE_INVALID	Das Patchpaket ist ungültig.
ERROR_PATCH_PACKAGE_UNSUPPORTED	Das Patchpaket kann von dieser Version des Windows Installer-Diensts nicht verarbeitet werden.
ERROR_PATCH_REMOVAL_UNSUPPORTED	Das Patchpaket kann nicht entfernt werden.
ERROR_UNKNOWN_PATCH	Der Patch wurde nicht auf dieses Produkt angewendet.
ERROR_PATCH_REMOVAL_DISALLOWED	Das Entfernen von Patches wurde von der Richtlinie nicht zugelassen.

Bemerkungen

Unter Uninstalling Patches finden Sie ein Beispiel, in dem veranschaulicht wird, wie eine Anwendung einen Patch aus allen Produkten entfernen kann, die für den Benutzer verfügbar sind.

Anmerkung

Der msi.h-Header definiert MsiRemovePatches 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