PatchMetadata-Tabelle (PATCHWIZ.DLL)

Die PatchMetadata-Tabelle enthält Informationen zu einem Windows Installer-Patch, der zum Entfernen von Patches erforderlich ist und von „Software“ verwendet wird. Alle Eigenschaften in der PatchMetadata-Tabelle werden der MsiPatchMetadata-Tabelle der MSP-Datei für einen Patch hinzugefügt.

Die PatchMetadata-Tabelle ist in Eigenschaftendateien für die Patcherstellung (PCP-Dateien) erforderlich, deren Eigenschaft „MinimumRequiredMsiVersion“ in der Properties-Tabelle auf „300“ festgelegt ist. Die Tabelle ist optional, wenn „MinimumRequiredMsiVersion“ nicht gleich 300 ist.

Die PatchMetadata-Tabelle enthält die folgenden Spalten:

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

 

Spalten

Company

Der Name des Unternehmens. Ein leeres Feld (NULL-Wert) gibt an, dass diese Zeile eine der Standardeigenschaften für Metadaten enthält. Ein Unternehmen kann die festgelegte Eigenschaft erweitern, indem es der Tabelle eine Zeile hinzufügt und in dieses Feld den Namen eines Unternehmens eingibt.

Property

Der Name einer Metadateneigenschaft. Die Eigenschaften „AllowRemoval“, „ManufacturerName“, „TargetProductName“, „MoreInfoURL“, „DisplayName“, „Description“ und „Classification“ sind in der PatchMetadata-Tabelle erforderlich. Ist das Feld „Company“ leer (NULL-Wert), muss dieses Feld eine der folgenden Standardeigenschaften für Metadaten enthalten.

Eigenschaft	BESCHREIBUNG
AllowRemoval	Ein ganzzahliger Wert, der angibt, ob es sich bei dem Patch um einen nicht deinstallierbaren Patch handelt. Bei einem Wert von 0 (null) kann der Patch nicht entfernt werden. Bei einem Wert von 1 (eins), ist der Patch nicht deinstallierbar. Diese Eigenschaft ist erforderlich. Die Eigenschaft wird registriert, und ihr Wert kann mit der Funktion MsiGetPatchInfoEx abgerufen werden.
ManufacturerName	Ein Zeichenfolgenwert, der den Namen des Herstellers der Anwendung enthält. Diese Eigenschaft ist obligatorisch.
MinorUpdateTargetRTM	Gibt an, dass der Patch auf die RTM-Version des Produkts oder den letzten Patch für größere Upgrades ausgerichtet ist. Erstellen Sie diese optionale Eigenschaft in Patches für kleinere Upgrades, die Sequenzierungsinformationen dazu enthalten, dass der Patch alle Patches bis zur RTM-Version des Produkts oder bis zum Patch für das letzte größere Upgrade entfernt. Diese Eigenschaft ist ab Windows Installer 3.1 verfügbar. Hinweis: Legen Sie die MinimumRequiredMsiVersion-Eigenschaft in der Eigenschaftentabelle der PCP-Datei auf 310 fest, um die Installation von Windows Installer 3.1 zum Anwenden des Patches zu verlangen.
TargetProductName	Ein Zeichenfolgenwert, der den Namen der Anwendung oder der Zielanwendungssuite enthält. Diese Eigenschaft ist obligatorisch.
MoreInfoURL	Ein Zeichenfolgenwert mit einer URL, die auf Informationen für diesen Patch verweist. Diese erforderliche Eigenschaft wird registriert, und ihr Wert kann mit der Funktion MsiGetPatchInfoEx abgerufen werden. Ab Windows XP mit Service Pack 2 (SP2) kann dieser Wert den Supportlink für den Patch darstellen, der unter „Software“ angezeigt wird.
CreationTimeUTC	Ein Zeichenfolgenwert, der die Erstellungszeit der MSP-Datei im Format „mm-dd-yy HH:MM“ (Monat-Tag-Jahr Stunde:Minute) enthält. Diese Eigenschaft ist optional.
DisplayName	Ein Zeichenfolgenwert, der einen Titel für den Patch enthält, der für die öffentliche Anzeige geeignet ist. Diese Eigenschaft ist obligatorisch. Diese Eigenschaft wird registriert, und ihr Wert kann mit der Funktion MsiGetPatchInfoEx abgerufen werden. Ab Windows XP mit SP2 stellt dieser Wert den Namen des Patches dar, der ab Windows XP mit SP2 unter „Software“ angezeigt wird.
BESCHREIBUNG	Ein Zeichenfolgenwert, der eine kurze Beschreibung des Patches enthält. Diese Eigenschaft ist obligatorisch.
Klassifizierung	Ein Zeichenfolgenwert, der die beliebige, vom Patchautor definierte Kategorie von Updates enthält. Patchautor*innen können beispielsweise angeben, dass jeder Patch als Hotfix, Sicherheitsrollup, kritisches Update, Update, Service Pack oder Updaterollup klassifiziert wird. Diese Eigenschaft ist obligatorisch.
OptimizedInstallMode	Ist diese Eigenschaft in allen Patches, die in einer Transaktion angewendet werden sollen, auf „1“ (eins) festgelegt, wird die Anwendung des Patches nach Möglichkeit optimiert. Weitere Informationen finden Sie unter Patchoptimierung. Verfügbar ab Windows Installer 3.1.

 

Value

Der Wert der Metadateneigenschaft. Dieser Wert kann niemals NULL oder eine leere Zeichenfolge sein. Der Wert kann lokalisiert werden.

Bemerkungen

Verfügbar ab Windows Installer 3.0.

Alle Eigenschaften in der PatchMetadata-Tabelle werden der MsiPatchMetadata-Tabelle der MSP-Datei hinzugefügt. Die Eigenschaften „AllowRemoval“, „MoreInfoURL“ und „DisplayName“ werden registriert und können über MsiGetPatchInfoEx abgerufen werden.