Properties Table (Patchwiz.dll)
Die Eigenschaftentabelle enthält globale Einstellungen für das Patchpaket. Die Eigenschaftentabelle ist in der Patcherstellungsdatenbank (PCP-Datei) erforderlich und wird von der funktion UiCreatePatchPackageEx verwendet.
Die Eigenschaftentabelle enthält die folgenden Spalten.
Spalte | Art | Schlüssel | Nullable |
---|---|---|---|
Name | Text | Y | N |
Wert | Text | Y |
Spalten
-
Name
-
Der Name einer Patcherstellungseigenschaft.
-
wert
-
Der Wert der Patcherstellungseigenschaft.
Bemerkungen
In der folgenden Tabelle sind die Zeichenfolgen für die Patcherstellungseigenschaft aufgeführt, die in die Eigenschaftentabelle der PCP-Datei eingegeben werden können.
Eigentum | Beschreibung |
---|---|
AllowLaxValidationFlags | Wenn diese Eigenschaft auf 1 festgelegt ist, wird ein Eintrag im Protokoll geschrieben und kein Fehler zurückgegeben, wenn das Feld "ProductValidateFlags" in der TargetImages-Tabelle nicht überprüft werden kann. Diese Eigenschaft sollte nur festgelegt werden, wenn der Patchautor den Wert im Feld "ProductValidateFlags" geändert hat. Der Standardwert für diese Eigenschaft ist 0. Verfügbar ab Patchwiz.dll Version 4.0. |
AllowProductCodeMismatches | Wird für "True" auf "1" festgelegt, wenn die ProductCode Property möglicherweise zwischen den aktualisierten Bildern abweichen kann, die in der UpgradedImages Table aufgeführt sind, und den Zielbildern, die in der TargetImages-Tabelleaufgeführt sind. Legen Sie "0" oder "Leer" auf "False" fest, wenn die Produktcodes identisch sein müssen. |
AllowProductVersionMajorMismatches | Legen Sie "1" auf "True" fest, wenn das erste Feld (hauptversionsfeld) des ProductVersion Property zwischen aktualisierten Bildern und Zielbildern abweichen kann. Legen Sie "0" oder "leer" auf "False" fest, wenn die Hauptversionen übereinstimmen müssen. |
ApiPatchingSymbolFlags | Eine 8-stellige hexadeziative ganze Zahl, die die Kombination aus Patchsymbol-Verwendungskennzeichnungen darstellt, die beim Erstellen eines Binärdateipatches verwendet werden sollen. Der Standardwert ist 0x00000000. Die vollständige Liste der möglichen PATCH_SYMBOL_*-Flags finden Sie unter Patchapi.h. Weitere Informationen zu Symboldateien finden Sie im Glossar. |
DontRemoveTempFolderWhenFinished | Auf "1" auf "True" festgelegt, wenn der temporäre Ordner, der die Transformationen enthält, die Patches auf Byteebene und die gesamten 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 "0" oder "Leer" auf "False" fest, wenn der temporäre Ordner entfernt werden soll. |
IncludeWholeFilesOnly | Auf "1" auf "True" festgelegt, wenn Dateien, die geändert werden, beim Erstellen des Patchpakets vollständig eingeschlossen werden sollen, anstatt einen Binärdateipatch zu erstellen. Die Patchdateien sind größer, aber die API wird schneller ausgeführt. Festlegen auf "0" oder "Leer" auf "False", wenn ein Binärdateipatch erstellt wird. |
ListOfPatchGUIDsToReplace | Eine Liste der PatchGUID-IDs ohne Trennzeichen. Wenn eines dieser Patches auf dem Computer des Benutzers installiert und bei Windows Installer registriert ist, werden sie vom entsprechenden Produkt nicht registriert, und ihre Patchtransformationen werden aus der Liste der Transformationen entfernt, die dem Produkt zugeordnet sind. Beachten Sie, dass das Entfernen eines Patches keines der Dateien betrifft, nur die Registrierung des Patches. Wahlfrei. |
ListOfTargetProductCodes | Eine Liste der Produktcodes für Produkte, die diesen Patch erhalten können. Dies ist eine durch Semikolons getrennte Liste ProductCode Property-Werte. Wenn die Liste mit einem Sternchen beginnt, wird die Liste der Produktcodes aus den .msi Dateien der Ziele generiert, die in der TargetImages Tableaufgeführt sind. Wenn alle Produktcodes einem führenden Sternchen folgen, werden sie an die Liste angefügt, die das Sternchen ersetzt. Wenn die Eigenschaft nicht festgelegt ist, wird eine Liste der Produktcodes aus den .msi Dateien der Ziele generiert, die in der TargetImages Tableaufgeführt sind. |
MsiFileToUseToCreatePatchTables | Der vollständige Pfad zu einer Vorlage .msi Datei, aus der die Patch Table und PatchPackage Tableexportiert werden soll. Optional.Die Eigenschaftentabelle 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 das Formatierte Spaltendatentyp. |
OptimizePatchSizeForLargeFiles | Diese Eigenschaft wird festgelegt, wenn der Wert vorhanden ist und nicht "0". Wenn diese Eigenschaft festgelegt ist, können Patches für Dateien, die größer als ca. 4 MB sind, 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 des Dateinamens, der Patchpaketdatei, die generiert werden soll. 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 Eigenschaftentabelle 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 das Formatierte Spaltendatentyp. |
PatchSourceList | Eine Quelle, die verwendet wird, um die MSP-Datei für den Patch zu suchen, 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. Wahlfrei. |
MinimumRequiredMsiVersion | Legen Sie diese Eigenschaft fest, um zu erzwingen, dass Patchwiz.dll einen Patch generieren, der eine bestimmte Version von Windows Installer erfordert. Dieser Eigenschaftswert hilft zu bestimmen, welcher Wert für die Word Count Summary Property des Patchpakets verwendet werden soll. Der Wert für diese Eigenschaft entspricht dem Seitenanzahlzusammenfassung Eigenschaft des Installationspakets. Wenn eine PCP-Datei eine MinimumRequiredMsiVersion aufweist, die 200 entspricht, legt Patchwiz.dll die Word Count Summary-Eigenschaft des Patchpakets auf 3 fest. Dadurch wird verhindert, dass der Patch von Der Windows Installer-Version vor Version 2.0 angewendet wird. Wenn eine PCP-Datei über eine MinimumRequiredMsiVersion gleich 300 verfügt, legt Patchwiz.dll die Word Count Summary Property des Patchpakets auf 4 fest. Dadurch wird verhindert, dass der Patch von Windows Installer-Versionen vor Version 3.0 angewendet wird. Wenn eine PCP-Datei eine MinimumRequiredMsiVersion gleich 310 aufweist, legt Patchwiz.dll die Word Count Summary Property des Patchpakets auf 5 fest. Dadurch wird verhindert, dass der Patch von Windows Installer vor Version 3.1 angewendet wird. Wenn eine PCP-Datei eine MinimumRequiredMsiVersion gleich 400 aufweist, legt Patchwiz.dll die Word Count Summary-Eigenschaft des Patchpakets auf 6 fest. Dadurch wird verhindert, dass der Patch von Windows Installer vor Version 4.0 angewendet wird. |
PATCH_CACHE_ENABLED | Legen Sie diese Eigenschaft auf 1 fest, um die Patcherstellungsinformationen im durch die eigenschaft PATCH_CACHE_DIR angegebenen Ordner zwischenzuspeichern. Die Patchzwischenspeicherung erhöht die Geschwindigkeit der Patcherstellung beim Erneuten Erstellen eines neuen Patches nach dem Aktualisieren des Updateimages. Diese Eigenschaft erfordert Patchwiz.dll in Windows Installer 2.0 oder höher. Weitere Informationen finden Sie unter Patchinformationszwischenspeicherung (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 Eigenschaftentabelle 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 das Formatierte Spaltendatentyp. |
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 Sequenzierungsinformationen automatisch generiert und hinzugefügt. |
SEQUENCE_DATA_SUPERSEDENCE | Legen Sie diese Eigenschaft auf 0 (Null) oder 1 (eins) fest, um diesen Wert im Feld "Attributes" aller Zeilen in der MsiPatchSequence-Tabellezu schreiben. |
TrustMsi | Legen Sie diese Eigenschaft in der Eigenschaftentabelle auf 1 fest, um die In der .msi-Datei bereitgestellten Dateiversionsinformationen, Größe und Hashwerte zu verwenden. Wenn diese Eigenschaft festgelegt ist, aber die Informationen in der .msi Datei falsch sind, funktioniert der erstellte Patch möglicherweise nicht ordnungsgemäß. Sie sollten das Ziel aktualisieren und .msi Dateien mithilfe von MsiFiler.exeaktualisieren. Der Standardwert für diese Eigenschaft ist 0. Verfügbar ab Patchwiz.dll Version 4.0. |