Freigeben über


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.