MsiApplyPatchW-Funktion (msi.h)
Für jedes Produkt, das vom Patchpaket als berechtigt zum Empfangen des Patches aufgeführt wird, ruft die MsiApplyPatch-Funktion eine Installation auf und legt die PATCH-Eigenschaft auf den Pfad des Patchpakets fest.
Syntax
UINT MsiApplyPatchW(
[in] LPCWSTR szPatchPackage,
[in] LPCWSTR szInstallPackage,
[in] INSTALLTYPE eInstallType,
[in] LPCWSTR szCommandLine
);
Parameter
[in] szPatchPackage
Eine NULL-endende Zeichenfolge, die den vollständigen Pfad zum Patchpaket angibt.
[in] szInstallPackage
Wenn eInstallType auf INSTALLTYPE_NETWORK_IMAGE festgelegt ist, ist dieser Parameter eine NULL-endende Zeichenfolge, die einen Pfad zu dem Produkt angibt, das gepatcht werden soll. Das Installationsprogramm wendet den Patch auf jedes berechtigte Produkt an, das im Patchpaket aufgeführt ist, wenn szInstallPackage auf NULL und eInstallType auf INSTALLTYPE_DEFAULT festgelegt ist.
Wenn eInstallType INSTALLTYPE_SINGLE_INSTANCE ist, wendet das Installationsprogramm den Patch auf das durch szInstallPackage angegebene Produkt an. In diesem Fall werden andere berechtigte Produkte, die im Patchpaket aufgeführt sind, ignoriert, und der szInstallPackage-Parameter enthält die Zeichenfolge mit NULL-Beendigung, die den Produktcode der zu patchende instance darstellt. Für diese Art von Installation ist das Installationsprogramm mit Windows Server 2003 oder Windows XP erforderlich.
[in] eInstallType
Dieser Parameter gibt den Typ der zu patchenden Installation an.
| Art der Installation | Bedeutung |
|---|---|
|
Gibt eine Administratorinstallation an. In diesem Fall muss szInstallPackage auf einen Paketpfad festgelegt werden. Der Wert 1 für INSTALLTYPE_NETWORK_IMAGE legt dies für eine Administratorinstallation fest. |
|
Durchsucht das System nach zu patchenden Produkten. In diesem Fall muss szInstallPackage 0 sein. |
|
Patchen Sie das durch szInstallPackage angegebene Produkt. szInstallPackage ist der Produktcode des zu patchenden instance. Diese Art der Installation erfordert das Installationsprogramm unter Windows Server 2003 oder Windows XP mit SP1. Weitere Informationen finden Sie unter Installieren mehrerer Instanzen von Produkten und Patches. |
[in] szCommandLine
Eine NULL-endende Zeichenfolge, die Befehlszeileneigenschafteneinstellungen angibt. Weitere Informationen finden Sie unter Informationen zu Eigenschaften und Festlegen öffentlicher Eigenschaftswerte in der Befehlszeile. Weitere Informationen finden Sie im Abschnitt mit den Hinweisen.
Rückgabewert
| Wert | Bedeutung |
|---|---|
|
Die Funktion wurde erfolgreich abgeschlossen. |
|
Das Patchpaket konnte nicht geöffnet werden. |
|
Das Patchpaket ist ungültig. |
|
Das Patchpaket wird nicht unterstützt. |
|
Weitere Informationen finden Sie unter Fehlercodes. |
| Initialisierungsfehler. |
Bemerkungen
Da das Listentrennzeichen für Transformationen, Quellen und Patches ein Semikolon ist, sollte dieses Zeichen nicht für Dateinamen oder Pfade verwendet werden.
Sie müssen die REINSTALL-Eigenschaft in der Befehlszeile festlegen, wenn Sie ein kleines Update oder einen kleinen Upgradepatch anwenden. Ohne diese Eigenschaft wird der Patch auf dem System registriert, kann jedoch keine Dateien aktualisieren. Für Patches, die keinen benutzerdefinierten Aktionstyp 51 verwenden, um die Eigenschaften REINSTALL und REINSTALLMODE automatisch festzulegen, muss die REINSTALL-Eigenschaft explizit mit dem SzCommandLine-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“. Ab Windows Installer Version 3.0 wird die REINSTALL-Eigenschaft vom Installationsprogramm konfiguriert und muss nicht über die Befehlszeile festgelegt werden.
Hinweis
Der msi.h-Header definiert MsiApplyPatch 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. Windows Installer unter Windows Server 2003 oder Windows XP. Informationen zum mindestens 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 |