Properties-Tabelle (Patchwiz.dll)

Die Properties-Tabelle enthält globale Einstellungen für das Patchpaket. Die Properties-Tabelle ist muss in der Patcherstellungsdatenbank (PCP-Datei) vorhanden sein und wird von der UiCreatePatchPackageEx-Funktion verwendet.

Die Properties-Tabelle umfasst die folgenden Spalten.

Spalte	Typ	Schlüssel	Nullwerte zulässig
Name	text	J	N
Wert	text		J

 

Spalten

Name

Der Name einer Patcherstellungseigenschaft.

Value

Der Wert der Patcherstellungseigenschaft.

Bemerkungen

In der folgenden Tabelle finden Sie die Zeichenfolgen für Patcherstellungseigenschaften, die in die Properties-Tabelle der PCP-Datei eingegeben werden können.

Eigenschaft	BESCHREIBUNG
AllowLaxValidationFlags	Wenn diese Eigenschaft auf 1 festgelegt ist, wird ein Eintrag in das Protokoll geschrieben, und es wird kein Fehler zurückgegeben, wenn das ProductValidateFlags-Feld in der TargetImages-Tabelle nicht überprüft werden kann. Diese Eigenschaft sollte nur festgelegt werden, wenn der Patchersteller den Wert im ProductValidateFlags-Feld geändert hat. Der Standardwert für diese Eigenschaft ist 0. Verfügbar ab Patchwiz.dll-Version 4.0.
AllowProductCodeMismatches	Legen Sie diesen Wert auf „1“ für „true“ fest, wenn sich die ProductCode-Eigenschaft zwischen den in der UpgradedImages-Tabelle aufgeführten aktualisierten Images und den in der TargetImages-Tabelle aufgeführten Zielimages unterscheiden kann. Legen Sie den Wert auf „0“ oder auf einen leeren Wert für „false“ fest, wenn die Produktcodes identisch sein müssen.
AllowProductVersionMajorMismatches	Legen Sie diesen Wert auf „1“ für „true“ fest, wenn sich das erste Feld (das Hauptversionsfeld) der ProductVersion-Eigenschaft zwischen aktualisierten Images und Zielimages unterscheiden kann. Legen Sie den Wert auf „0“ oder auf einen leeren Wert für „false“ fest, wenn die Hauptversionen übereinstimmen müssen.
ApiPatchingSymbolFlags	Eine 8-stellige hexadezimale Ganzzahl, die die Kombination der Flags für die Patchsymbolverwendung darstellt, die beim Erstellen eines Binärdateipatches verwendet werden sollen. Der Standardwert ist 0x00000000. Eine vollständige Liste möglicher PATCH_SYMBOL_*-Flags finden Sie in Patchapi.h. Weitere Informationen zu Symboldateien finden Sie im Glossar.
DontRemoveTempFolderWhenFinished	Legen Sie diesen Wert auf „1“ für „true“ fest, wenn der temporäre Ordner, der die Transformationen enthält, die Patches auf Byteebene und alle neuen Dateien nach dem Erstellen des Patchpakets nicht entfernt werden. Dies ist im Wesentlichen der Inhalt der MSP-Datei, bevor sie in das Patchpaket eingebettet wird. Dies kann für das Debuggen von Patches nützlich sein. Legen Sie den Wert auf „0“ oder auf einen leeren Wert für „false“ fest, wenn der temporäre Ordner entfernt werden soll.
IncludeWholeFilesOnly	Legen Sie diesen Wert auf „1“ für „true“ fest, wenn Dateien, die geändert werden, beim Erstellen des Patchpakets vollständig eingeschlossen werden sollen und kein Binärdateipatch erstellt werden soll. Die Patchdateien sind größer, aber die API wird schneller ausgeführt. Legen Sie den Wert auf „0“ oder auf einen leeren Wert für „false“ fest, wenn ein Binärdateipatch erstellt wird.
ListOfPatchGUIDsToReplace	Eine Liste von PatchGUID-Bezeichnern ohne Trennzeichen. Wenn festgestellt wird, dass einer dieser Patches auf dem Computer des Benutzers installiert und bei Windows Installer registriert ist, wird deren Registrierung für das entsprechende Produkt aufgehoben, und deren Patchtransformationen werden aus der Liste der Transformationen entfernt, die dem Produkt zugeordnet sind. Beachten Sie, dass das Entfernen eines Patches keine Auswirkung auf die Dateien hat, sondern nur auf die Registrierung des Patches. Optional.
ListOfTargetProductCodes	Eine Liste der Produktcodes für Produkte, für die diese Patch angewendet werden kann. Dies ist eine durch Semikolons getrennte Liste mit den Werten der ProductCode-Eigenschaft. Wenn die Liste mit einem Sternchen beginnt, wird die Liste der Produktcodes aus den MSI-Dateien der in der TargetImages-Tabelle aufgeführten Ziele generiert. Wenn Produktcodes hinter einem führenden Sternchen stehen, werden sie an die Liste angefügt und das Sternchen ersetzt. Wenn die Eigenschaft nicht festgelegt ist, wird die Liste der Produktcodes aus den MSI-Dateien der in der TargetImages-Tabelle aufgeführten Ziele generiert.
MsiFileToUseToCreatePatchTables	Der vollständige Pfad zu einer MSI-Vorlagendatei, aus der die Patch-Tabelle und die PatchPackage-Tabelle exportiert werden sollen. Optional. Die Properties-Tabelle akzeptiert Umgebungsvariablen für Pfade ab Version 4.0 von Patchwiz.dll. Verwenden Sie das Windows-Format für die Umgebungsvariable, z. B. %ENV_VAR%. Verwenden Sie nicht den Formatted-Datentyp.
OptimizePatchSizeForLargeFiles	Diese Eigenschaft wird festgelegt, wenn der Wert vorhanden und nicht „0“ ist. Wenn diese Eigenschaft festgelegt ist, können Patches für Dateien mit einer Größe von wehr als ungefähr 4 MB kleiner gemacht werden.
PatchGUID	Ein GUID-Bezeichner für dieses Patchpaket (MSP-Datei). Jedes Patchpaket muss über einen eindeutigen PatchGUID-Wert verfügen. Erforderlich.
PatchOutputPath	Der vollständige Pfad, einschließlich Dateinamen, der zu generierenden Patchpaketdatei. Wenn szPatchPath von der UiCreatePatchPackageEx-Funktion übergeben wird, wird der übergebene Wert verwendet. Diese Eigenschaft ist erforderlich, wenn szPatchPath NULL oder eine leere Zeichenfolge ist. Die Properties-Tabelle akzeptiert Umgebungsvariablen für Pfade ab Version 4.0 von Patchwiz.dll. Verwenden Sie das Windows-Format für die Umgebungsvariable, z. B. %ENV_VAR%. Verwenden Sie nicht den Formatted-Datentyp.
PatchSourceList	Eine Quelle, in der die MSP-Datei für den Patch gesucht werden soll, falls die lokal zwischengespeicherte Kopie nicht verfügbar ist. Dieser Wert wird der Quellliste des Patches hinzugefügt, wenn er auf ein Produkt angewendet wird. Optional.
MinimumRequiredMsiVersion	Legen Sie diese Eigenschaft fest, damit Patchwiz.dll einen Patch generiert, für den eine bestimmte Version von Windows Installer erforderlich ist. Mit dem Wert dieser Eigenschaft kann bestimmt werden, welcher Wert für die Word Count Summary-Eigenschaft des Patchpakets verwendet werden soll. Der Wert für diese Eigenschaft weist dieselbe Form wie die Page Count Summary-Eigenschaft des Installationspakets auf. Wenn eine PCP-Datei eine MinimumRequiredMsiVersion von 200 aufweist, legt Patchwiz.dll die Word Count Summary-Eigenschaft des Patchpakets auf 3 fest. Dadurch wird verhindert, dass der Patch von einer Windows Installer-Version vor Version 2.0 angewendet wird. Wenn eine PCP-Datei eine MinimumRequiredMsiVersion von 300 aufweist, legt Patchwiz.dll die Word Count Summary-Eigenschaft des Patchpakets auf 4 fest. Dadurch wird verhindert, dass der Patch von einer Windows Installer-Version vor Version 3.0 angewendet wird. Wenn eine PCP-Datei eine MinimumRequiredMsiVersion von 310 aufweist, legt Patchwiz.dll die Word Count Summary-Eigenschaft des Patchpakets auf 5 fest. Dadurch wird verhindert, dass der Patch von einer Windows Installer-Version vor Version 3.1 angewendet wird. Wenn eine PCP-Datei eine MinimumRequiredMsiVersion von 400 aufweist, legt Patchwiz.dll die Word Count Summary-Eigenschaft des Patchpakets auf 6 fest. Dadurch wird verhindert, dass der Patch von einer Windows Installer-Version vor Version 4.0 angewendet wird.
PATCH_CACHE_ENABLED	Legen Sie diese Eigenschaft auf 1 fest, um die Informationen zur Patcherstellung in dem Ordner zwischenzuspeichern, der über die PATCH_CACHE_DIR-Eigenschaft angegeben wird. Die Patchzwischenspeicherung erhöht die Geschwindigkeit der Patcherstellung, wenn nach dem Aktualisieren des Aktualisierungsimages ein neuer Patch erstellt wird. Diese Eigenschaft erfordert Patchwiz.dll in Windows Installer 2.0 oder höher. Weitere Informationen finden Sie im Thema zum Zwischenspeichern von Patchinformationen (Patchwiz.dll).
PATCH_CACHE_DIR	Legen Sie diese Eigenschaft auf den Namen des Ordners fest, in dem die zwischengespeicherten Patchinformationen gespeichert werden. Patchwiz.dll erstellt diesen Ordner bei Bedarf. Der Ordner sollte sich auf einem Laufwerk mit ausreichendem Speicherplatz befinden. Diese Eigenschaft wird nur verwendet, wenn die PATCH_CACHE_ENABLED-Eigenschaft auf 1 festgelegt ist. Die Properties-Tabelle akzeptiert Umgebungsvariablen für Pfade ab Version 4.0 von Patchwiz.dll. Verwenden Sie das Windows-Format für die Umgebungsvariable, z. B. %ENV_VAR%. Verwenden Sie nicht den Formatted-Datentyp.
SEQUENCE_DATA_GENERATION_DISABLED	Legen Sie diese Eigenschaft auf 1 (eins) fest, um die automatische Generierung von Patchsequenzierungsinformationen zu verhindern. Wenn diese Eigenschaft nicht vorhanden ist, werden automatisch Sequenzierungsinformationen generiert und hinzugefügt.
SEQUENCE_DATA_SUPERSEDENCE	Legen Sie diese Eigenschaft auf 0 (null) oder 1 (eins) fest, wenn der jeweilige Wert in das Attributes-Feld aller Zeilen in der MsiPatchSequence-Tabelle geschrieben werden soll.
TrustMsi	Legen Sie diese Eigenschaft in der Properties-Tabelle auf 1 fest, wenn die Dateiversionsinformationen, die Größe und die Hashwerte, die in der MSI-Datei angegeben sind, verwendet werden sollen. Wenn diese Eigenschaft festgelegt ist, aber die Informationen in der MSI-Datei nicht richtig sind, funktioniert der erstellte Patch möglicherweise nicht ordnungsgemäß. Sie sollten die MSI-Zieldatei und die aktualisierte MSI-Datei mithilfe von MsiFiler.exe aktualisieren. Der Standardwert für diese Eigenschaft ist 0. Verfügbar ab Patchwiz.dll-Version 4.0.