Database.CreateTransformSummaryInfo-Methode

  • Artikel

Die CreateTransformSummaryInfo-Methode des Database-Objekts erstellt und füllt den Zusammenfassungsinformationsdatenstrom einer vorhandenen Transformationsdatei auf. Diese Methode füllt die Eigenschaften mit der Basis aus und verweist auf ProductCode und ProductVersion.

Syntax

Database.CreateTransformSummaryInfo(
  reference,
  storage,
  errorConditions,
  validation
)

Parameter

Referenz

Die erforderliche Datenbank, die die Änderungen nicht enthält.

storage

Der Name der erzeugten Transformationsdatei. Diese Eingabe ist optional.

errorConditions

Erforderliche Fehlerbedingungen, die beim Anwenden der Transformation unterdrückt werden sollten. Kombinieren Sie einen oder mehrere der folgenden Fehlerbedingungswerte.

Name der Fehlerbedingung Bedeutung
msiTransformErrorNone
0
 Keine der folgenden Bedingungen.
msiTransformErrorAddExistingRow
1
 Fügt eine Zeile hinzu, die bereits vorhanden ist.
msiTransformErrorDeleteNonExistingRow
2
 Löscht eine Zeile, die nicht vorhanden ist.
msiTransformErrorAddExistingTable
4
 Fügt eine Tabelle hinzu, die bereits vorhanden ist.
msiTransformErrorDeleteNonExistingTable
8
 Löscht eine Tabelle, die nicht vorhanden ist.
msiTransformErrorUpdateNonExistingRow
16
 Aktualisiert eine Zeile, die nicht vorhanden ist.
msiTransformErrorChangeCodepage
32
 Transformations- und Datenbankcodepages stimmen nicht überein, und keine der Codepages ist neutral.

validation

Erforderlich, wenn die Transformation auf eine Datenbank angewendet wird. Zeigt an, welche Eigenschaften überprüft werden sollen, um sicherzustellen, dass diese Transformation auf die Datenbank angewendet werden kann. Die Eigenschaften sind alle im Eigenschaftensatz des Zusammenfassungsinformationsstreams enthalten.

Kombinieren Sie einen oder mehrere der folgenden Werte.

Validierungsflag Bedeutung
msiTransformValidationNone
0
 Es ist keine Validierung erfolgt.
msiTransformValidationLanguage
1
 Die Standardsprache muss mit der Basisdatenbank übereinstimmen.
msiTransformValidationProduct
2
 Das Produkt muss mit der Basisdatenbank übereinstimmen.

Um die Produktversion zu überprüfen, wählen Sie zunächst eines oder mehrere dieser drei Flags aus, um anzugeben, inwieweit die Version überprüft werden soll.

Validierungsflag Bedeutung
msiTransformValidationMajorVer
8
 Überprüft nur die Hauptversion.
msiTransformValidationMinorVer
16
 Überprüft nur die Haupt- und Nebenversion.
msiTransformValidationUpdateVer
32
 Überprüft die Haupt-, Neben- und Updateversionen.

Wählen Sie dann eine der folgenden Optionen aus, um die erforderliche Beziehung zwischen der Produktversion der Datenbank, auf die die Transformation angewendet wird, und der der Basisdatenbank anzugeben.

Validierungsflag Bedeutung
msiTransformValidationLess
64
 Angewendete Version < Basisversion
msiTransformValidationLessOrEqual
128
 Angewendete Version <= Basisversion
msiTransformValidationEqual
256
 Angewendete Version = Basisversion
msiTransformValidationGreaterOrEqual
512
 Angewendete Version >= Basisversion
msiTransformValidationGreater
1024
 Angewendete Version > Basisversion

Um zu überprüfen, ob die Transformation auf ein Paket mit dem entsprechenden UpgradeCode angewendet wird, legen Sie das folgende Flag fest.

Validierungsflag Bedeutung
msiTransformValidationUpgradeCode
2048
 Überprüft, ob die Transformation der entsprechende UpgradeCode ist.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Um einen Zusammenfassungsinformationsdatenstrom für eine Transformation zu erstellen, müssen die Eigenschaften ProductCode und ProductVersion in den Property-Tabellen sowohl der Basisdatenbank als auch der Verweisdatenbank definiert werden. Bei Verwendung von „msiTransformValidationUpgradeCode“ muss die UpgradeCode-Eigenschaft in beiden Datenbanken definiert werden.

Anforderungen

Anforderung Wert
Version
 Windows Installer 5.0 unter Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 unter Windows Server 2008 oder Windows Vista. Windows Installer unter Windows Server 2003 oder Windows XP
DLL
Msi.dll
IID
 IID_IDatabase ist definiert als 000C109D-0000-0000-C000-000000000046

Siehe auch

Datenbanktransformationen