UiCreatePatchPackageEx (Patchwiz.dll)

Die UiCreatePatchPackageEx-Funktion verwendet eine Paketerstellungsdatei (PCP-Datei) und generiert ein Windows Installer-Patchpaket (MSP-Paket). Das Aufrufen vonMsimsp.exe ist die empfohlene Methode für die Verwendung vonPatchwiz.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 Eigenschaftendatei für die 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 oder eine leere Zeichenfolge sein, aber nicht ausgelassen werden. Wenn es sich um NULL oder eine leere Zeichenfolge handelt, 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 oder eine leere Zeichenfolge sein, aber nicht ausgelassen werden.

hwndStatus

Handle für ein Fenster, in dem der Statustext angezeigt wird. Dieser Parameter kann NULL oder eine leere Zeichenfolge sein, aber nicht ausgelassen werden.

szTempFolder

Speicherort für temporäre Dateien. Dieser Parameter kann NULL oder eine leere Zeichenfolge sein, aber nicht ausgelassen 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, sofern vorhanden. Wenn FALSE und der Ordner vorhanden sind, schlägt die Funktion fehl.

Dwflags

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

Flag 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 Zeigt die Benutzeroberfläche an.

dwReserved

Reserviert. Dieser Parameter muss auf 0 (null) festgelegt werden.

Rückgabewerte

Weitere Informationen finden Sie in der Tabelle unter 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 Administratives Image oder ein nicht komprimiertes Setupimage von einer CD-ROM. UiCreatePatchPackage generiert keine binären Patches für Dateien in Schränken.