UiCreatePatchPackage (Patchwiz.dll)

Die UiCreatePatchPackageEx-Funktion generiert mithilfe einer Paketerstellungsdatei (PCP-Datei) ein Windows Installer-Patchpaket (MSP-Paket). Der Aufruf von Msimsp.exe ist die empfohlene Methode zur Verwendung von Patchwiz.dll. Die UiCreatePatchPackageEx-Funktion ist in Patchwiz.dll-Version 4.0 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 Datei mit den Eigenschaften zur Patcherstellung (PCP-Datei) für diesen Patch.

szPatchPath

Vollständiger Pfad zum Windows Installer-Patchpaket (MSP-Datei), das erstellt werden soll. Dieser Parameter kann NULL lauten oder eine leere Zeichenfolge sein, darf aber nicht ausgelassen werden. Wenn der Parameter NULL lautet oder eine leere Zeichenfolge ist, verwendet die Funktion den Wert von „PatchOutputPath“ in der Eigenschaftentabelle (Patchwiz.dll).

szLogPath

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

hwndStatus

Handle zu einem Fenster, das den Statustext anzeigt. Dieser Parameter kann NULL lauten oder eine leere Zeichenfolge sein, darf aber nicht ausgelassen werden.

szTempFolder

Speicherort für temporäre Dateien. Dieser Parameter kann NULL lauten oder eine leere Zeichenfolge sein, darf aber nicht ausgelassen werden. Der Standardspeicherort lautet „%TMP%\~pcw_tmp.tmp\“.

fRemoveTempFolderContents

Lautet der Parameter TRUE, wird der temporäre Ordner und ggf. dessen gesamter Inhalt entfernt. Lautet der Parameterwert FALSE und ist ein Ordner vorhanden, schlägt die Funktion fehl.

Rückgabewerte

Siehe 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 Beispiel für einen kleinen Updatepatch.

Zum Erstellen eines Patches ist ein unkomprimiertes Setupimage erforderlich, z. B. ein administratives Image oder ein unkomprimiertes Setupimage von einer CD-ROM. UiCreatePatchPackage generiert keine binären Patches für CAB-Dateien.