TargetImages-Tabelle (Patchwiz.dll)

Die TargetImages-Tabelle enthält Informationen zu den Zielimages des Produkts. Ein Windows Installer-Patchpaket aktualisiert ein Zielimage in ein aktualisiertes Image.

Eine TargetImages-Tabelle, die mindestens einen Datensatz enthält, wird in jeder Patcherstellungsdatenbank (.pcp-Datei) benötigt. Diese Tabelle wird von der UiCreatePatchPackage-Funktion verwendet.

Die TargetImages-Tabelle enthält folgende Spalten.

Spalte	Typ	Schlüssel	Nullwerte zulässig
Ziel	text	J	N
MsiPath	text		N
SymbolPaths	text		J
Upgraded	text		N
Order	integer		N
ProductValidateFlags	text		J
IgnoreMissingSrcFiles	integer		N

 

Spalten

Ziel-

Bezeichner für ein Zielimage. Das Patchpaket aktualisiert das in dieser Spalte angegebene Zielimage auf das aktualisierte Image, das in der Upgraded-Spalte angegeben ist. Es gibt mindestens ein Zielimage für jedes aktualisierte Image. Das Zielimage muss ein vollständig unkomprimiertes Setupimage des Produkts sein, z. B. ein Administratorimage oder ein nicht komprimiertes Setupimage auf einer CD-ROM. Beachten Sie, dass die UiCreatePatchPackageEx-Funktion keine binären Patches für Dateien in Cabinets generiert. Der Wert in diesem Feld wird zusammen mit dem Wert im Feld Upgraded verwendet, um die Namen der Transformationen zu generieren, die das Installationsprogramm dem Patchpaket hinzufügt.

MsiPath

Dieses Feld gibt den vollständigen Pfad einschließlich des Dateinamens zum Speicherort der .msi-Datei für das Zielimage an. Dies ist der Speicherort der Quelldateien für das Zielimage.

SymbolPaths

Eine durch Semikolon getrennte Liste von Ordnern, die nach Symboldateien durchsucht werden sollen, mit denen die Generierung des binären Patches optimiert werden kann. Beachten Sie, dass die in diesem Feld angegebenen Unterverzeichnisse von Ordnern nicht durchsucht werden. Ein optimierter binärer Patch kann kleiner sein. Microsoft Visual C++ muss auf dem Computer installiert sein, auf dem der Patch generiert wird, und zum Erstellen der Symboldateien verwendet werden. Dieses Feld ist optional, und das Installationsprogramm erstellt auch dann einen binären Patch, wenn keine Symboldateien angegeben sind oder wenn die Symboldateien für Patchwiz.dll nicht mehr verfügbar sind.

Upgraded

Fremdschlüssel für die Upgraded-Spalte der UpgradeImages-Tabelle. Die UiCreatePatchPackageEx-Funktion ignoriert alle aktualisierten Images, auf die nicht von mindestens einem Datensatz der TargetImages-Tabelle verwiesen wird.

Order

Relative Reihenfolge des Zielbilds. Da mehrere Ziele auf ein aktualisiertes Image gepatcht werden können, bietet das Order-Feld die Möglichkeit zum Sequenzieren der Transformationen in der Liste der Patchtransformationen. In der Regel verläuft die Reihenfolge vom ältesten zum neuesten Image.

ProductValidateFlags

Mit dem ProductValidateFlags-Feld wird die Produktüberprüfung angegeben, um irrelevante Transformationen zu vermeiden. Der in dieses Feld eingegebene Wert muss eine 8-stellige Hexadezimalzahl und einer der gültigen Werte für den iValidation-Parameter der MsiCreateTransformSummaryInfo-Funktion sein. Der Standardwert ist 0x00000922 und entspricht MSITRANSFORM_VALIDATE_UPDATEVERSION + MSITRANSFORM_VALIDATE_NEWEQUALBASEVERSION + MSITRANSFORM_VALIDATE_UPGRADECODE + MSITRANSFORM_VALIDATE_PRODUCT.

IgnoreMissingSrcFiles

Wenn dieses Feld auf einen anderen Wert als null festgelegt ist, werden Dateien, die im Zielimage fehlen, vom Installationsprogramm ignoriert und beim Patchen unverändert gelassen. Dadurch können Patches erstellt werden, ohne dass das gesamte Image benötigt wird; nur die geänderten Dateien des Produkts und die .msi-Datei werden benötigt. Dadurch kann die Zeit verkürzt werden, die zum Generieren des Patches erforderlich ist.

Hinweis

Verwenden Sie nicht den IgnoreMissingSrcFiles-Wert, wenn TrustMsi in der Properties-Tabelle auf 1 festgelegt ist.

 

Bemerkungen

Diese Tabelle akzeptiert Umgebungsvariablen als Pfade ab Version 4.0 von Patchwiz.dll.