UiCreatePatchPackageEx (Patchwiz.dll)

Die UiCreatePatchPackageEx-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 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 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 Benutzer muss über ausreichende Berechtigungen zum Lesen und Schreiben in diesen Ordner verfügen. 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.

dwFlags-

Dieser Parameter kann auf eine oder eine Kombination der folgenden Werte festgelegt werden, um Protokollierungs- oder Benutzeroberflächenoptionen anzugeben.

Flagge	Wert	Bedeutung
LOGNONE	0x00000000	Schreiben Sie keine Nachrichten in das Protokoll.
LOGINFO	0x00000001	Schreiben Sie Informationsmeldungen in das Protokoll.
LOGWARN	0x00000002	Schreiben sie Warnungen in das Protokoll.
LOGERR	0x00000004	Schreiben sie Fehlermeldungen in das Protokoll.
LOGPERFMESSAGES	0x00000008	Schreiben Sie Leistungsmeldungen in das Protokoll.
UINONE	0x00000000f	Zeigen Sie die Benutzeroberfläche nicht an.
UIALL	0x00000010	Zeigen Sie die Benutzeroberfläche an.

 

dwReserved

Reserviert. Dieser Parameter muss auf Null festgelegt werden.

Rückgabewerte

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

Bemerkungen

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

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.