UiCreatePatchPackageEx (Patchwiz.dll)

Die UiCreatePatchPackageEx-Funktion akzeptiert eine Paketerstellungsdatei (PCP-Datei) als Eingabe, um ein Windows Installer-Patchpaket (MSP-Paket) zu generieren. Der Aufruf von Msimsp.exe ist die empfohlene Methode zur Verwendung von Patchwiz.dll.

Die UiCreatePatchPackageEx-Funktion ist ab Patchwiz.dll-Version 4.0 verfügbar und erweitert die Funktionalität der UiCreatePatchPackage-Funktion.

UINT UiCreatePatchPackageEx(
  LPCTSTR szPcpPath,              
  LPCTSTR szPatchPath,            
  LPCTSTR szLogPath,             
  HWND hwndStatus,                
  LPCTSTR szTempFolder,           
  BOOL fRemoveTempFolderContents,
  DWORD dwFlags,
  DWORD dwReserved    
);

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. Die Benutzer*innen müssen über ausreichende Berechtigungen zum Lesen und Schreiben in diesem Ordner verfügen. 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.

dwFlags

Dieser Parameter kann auf einen der folgenden Werte oder eine Kombination davon festgelegt werden, um Optionen für die Protokollierung oder die Benutzeroberfläche anzugeben.

Flag	Wert	Bedeutung
LOGNONE	0x00000000	Es werden keine Meldungen in das Protokoll geschrieben.
LOGINFO	0x00000001	Es werden Informationsmeldungen in das Protokoll geschrieben.
LOGWARN	0x00000002	Es werden Warnungen in das Protokoll geschrieben.
LOGERR	0x00000004	Es werden Fehlermeldungen in das Protokoll geschrieben.
LOGPERFMESSAGES	0x00000008	Es werden Leistungsmeldungen in das Protokoll geschrieben.
UINONE	0x00000000f	Die Benutzeroberfläche wird nicht angezeigt.
UIALL	0x00000010	Die Benutzeroberfläche wird angezeigt.

 

dwReserved

Reserviert. Dieser Parameter muss auf 0 festgelegt werden.

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.

Um einen Patch zu erstellen, benötigen Sie ein unkomprimiertes Setupimage, z. B. ein administratives Image oder ein unkomprimiertes Setupimage von einer CD-ROM. UiCreatePatchPackage generiert keine binären Patches für CAB-Dateien.