UiCreatePatchPackage (Patchwiz.dll)

Die UiCreatePatchPackage-Funktion verwendet eine Paketerstellungsdatei (PCP-Datei) und generiert ein Windows Installer-Patchpaket (MSP-Paket). Das Aufrufen von Msimsp.exe ist die empfohlene Methode für die Verwendung von Patchwiz.dll. Die funktion UiCreatePatchPackageEx ist in Version 4.0 von Patchwiz.dll verfügbar und erweitert die Funktionalität der UiCreatePatchPackage-Funktion.

UINT UiCreatePatchPackage(
  LPCTSTR szPcpPath,              
  LPCTSTR szPatchPath,            
  LPCTSTR szLogPath,             
  HWND hwndStatus,                
  LPCTSTR szTempFolder,           
  Bool fRemoveTempFolderContents  
);

Parameter

szPcpPath-

Vollständiger Pfad zur Patcherstellungseigenschaftendatei (PCP-Datei) für diesen Patch.

szPatchPath-

Vollständiger Pfad zum Windows Installer-Patchpaket (MSP-Datei), das erstellt werden soll. Dieser Parameter kann NULL- oder eine leere Zeichenfolge sein, aber nicht angegeben werden. Wenn es NULL- oder eine leere Zeichenfolge ist, verwendet die Funktion den Wert von PatchOutputPath in der Properties Table (Patchwiz.dll).

szLogPath-

Vollständiger Pfad zu einer Textdatei, die angefügt wird. Dieser Parameter kann NULL- oder eine leere Zeichenfolge sein, aber nicht angegeben werden.

hwndStatus-

Behandeln Sie ein Fenster, in dem der Statustext angezeigt wird. Dieser Parameter kann NULL- oder eine leere Zeichenfolge sein, aber nicht angegeben werden.

szTempFolder

Speicherort für temporäre Dateien. Dieser Parameter kann NULL- oder eine leere Zeichenfolge sein, aber nicht angegeben werden. Der Standardspeicherort ist %TMP%\~pcw_tmp.tmp\.

fRemoveTempFolderContents

Wenn TRUE, entfernen Sie den temporären Ordner und den gesamten Inhalt, falls vorhanden. Wenn FALSE-vorhanden ist und der Ordner vorhanden ist, schlägt die Funktion fehl.

Rückgabewerte

Siehe die Tabelle in Rückgabewerte für uiCreatePatchPackage.

Bemerkungen

Ein Beispiel für die Erstellung einer PCP-Datei und die Verwendung von UiCreatePatchPackage zum Generieren eines Windows Installer-Patchpakets finden Sie im Abschnitt A Small Update Patching Example.

Zum Erstellen eines Patches ist ein nicht komprimiertes Setupimage erforderlich, z. B. ein Administratorimage oder ein nicht komprimiertes Setupimage von einer CD-ROM. UiCreatePatchPackage generiert keine binären Patches für Dateien in Cabs.