ExternalFiles-Tabelle (Patchwiz.dll)
Die Tabelle ExternalFiles enthält Informationen zu bestimmten Dateien, die nicht Teil eines regulären Zielimages sind. Diese Dateien können in Produkten vorhanden sein, die von einem anderen Produkt, Upgrade oder Patch aktualisiert wurden. Diese Tabelle ist in der Patcherstellungsdatenbank (PCP-Datei) optional und wird von der UiCreatePatchPackageEx-Funktion verwendet.
Die Tabelle ExternalFiles enthält die folgenden Spalten.
| Spalte | Typ | Schlüssel | Nullwerte zulässig |
|---|---|---|---|
| Familie | text | J | N |
| FTK | text | J | N |
| FilePath | text | J | N |
| SymbolPfade | text | J | |
| IgnoreOffsets | text | J | |
| IgnoreLengths | text | J | |
| RetainOffsets | text | N | |
| Order | integer | J |
Spalten
-
Familie
-
Fremdschlüssel für die Spalte Family der ImageFamilies-Tabelle (Patchwiz.dll).
-
FTK
-
Fremdschlüssel in die Dateitabelle der .msi Datei des aktualisierten Images.
-
Filepath
-
Vollständiger Pfad der externen Datei einschließlich des Dateinamens. Das Feld FilePath wird verwendet, um die in der FTK-Spalte angegebene Datei zu suchen.
-
SymbolPaths
-
Vollständiger Pfad, der nach Symboldateien der in der FTK-Spalte angegebenen Datei durchsucht wurde.
-
IgnoreOffsets
-
Der Wert in diesem Feld ist eine durch Kommas getrennte Liste von Bereichsoffsetnummern für die Bereiche, die in der externen Datei ignoriert werden sollen. Reihenfolge und Anzahl der Bereiche in der Liste müssen mit den Elementen in der IgnoreLengths-Spalte übereinstimmen. Diese Spalte ist optional.
Die Werte können dezimal oder hexadezimal sein. Patchwiz.dll behandelt den Wert als hexadezimal, wenn ihm das Präfix "0x" vorangestellt ist. Die Spalten sind Zeichenfolgenspalten, und Patchwiz.dll konvertiert die Werte in ULONGs.
-
IgnoreLengths
-
Der Wert in diesem Feld ist eine durch Kommas getrennte Liste von Bereichslängen in Bytes für die Bereiche, die in der externen Datei ignoriert werden sollen. Die Reihenfolge und Anzahl der Bereiche in der Liste muss mit den Elementen in der IgnoreOffsets -Spalte übereinstimmen. Diese Spalte ist optional.
Die Werte können dezimal oder hexadezimal sein. Patchwiz.dll behandelt den Wert als hexadezimal, wenn ihm das Präfix "0x" vorangestellt ist. Die Spalten sind Zeichenfolgenspalten, und Patchwiz.dll konvertiert die Werte in ULONGs.
-
RetainOffsets
-
Der Wert in diesem Feld ist eine durch Kommas getrennte Liste von Bereichsoffsetnummern für die Bereiche, die in der externen Datei beibehalten werden sollen. Die Reihenfolge und Anzahl der Bereiche in der Liste muss mit den Elementen in der RetainOffsets -Spalte des entsprechenden Datensatzes in der FamilyFileRanges-Tabelle (Patchwiz.dll)übereinstimmen.
Die Werte können dezimal oder hexadezimal sein. Patchwiz.dll behandelt den Wert als hexadezimal, wenn ihm das Präfix "0x" vorangestellt ist. Die Spalten sind Zeichenfolgenspalten, und Patchwiz.dll konvertiert die Werte in ULONGs.
-
Bestellung
-
Wenn mindestens zwei Versionen für dieselbe externe Datei angegeben sind, kann die Tabelle mehrere Datensätze mit übereinstimmenden Werten in den Feldern FTK und Family enthalten. In diesem Fall kann das Feld Order die Reihenfolge der externen Dateien angeben, die beim Erstellen des Patches verwendet werden sollen. Die Reihenfolge reicht von der ältesten bis zur neuesten Version.
Bemerkungen
Diese Tabelle akzeptiert Umgebungsvariablen als Pfade ab Version 4.0 von Patchwiz.dll.