Database.CreateTransformSummaryInfo-Methode

Mit der CreateTransformSummaryInfo-Methode des Database-Objekts wird der Zusammenfassungsinformationsstream einer vorhandenen Transformationsdatei erstellt und aufgefüllt. Diese Methode füllt die Eigenschaften mit der Basis und dem Verweis ProductCode und ProductVersion auf.

Syntax

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

Parameter

Referenz

Erforderliche Datenbank, die die Änderungen nicht enthält.

storage

Der Name der generierten Transformationsdatei. Diese Eingabe ist optional.

errorConditions

Erforderliche Fehlerbedingungen, die unterdrückt werden sollten, wenn die Transformation angewendet wird. 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 Datenbankcodeseiten passen 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 zu überprüfen, ob diese Transformation auf die Datenbank angewendet werden kann. Die Eigenschaften sind alle im Eigenschaftensatz zusammenfassungsinformationsstream enthalten.

Kombinieren Sie einen oder mehrere der folgenden Werte.

Validierungsflag Bedeutung
msiTransformValidationNone
0
Keine Überprüfung 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, wie viel der Version überprüft werden soll.

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

Wählen Sie dann eine der folgenden Angaben 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 UpgradeCodeangewendet wird, legen Sie das folgende Flag fest.

Validierungsflag Bedeutung
msiTransformValidationUpgradeCode
2048
Überprüft, ob es sich bei der Transformation um den entsprechenden UpgradeCode handelt.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Um einen Zusammenfassungsinformationsstream für eine Transformation zu erstellen, müssen die Eigenschaften ProductCode und ProductVersion sowohl in den Property-Tabellen der Basis- als auch der Verweisdatenbank definiert werden. Wenn msiTransformValidationUpgradeCode verwendet wird, muss die UpgradeCode-Eigenschaft in beiden Datenbanken definiert werden.

Requirements (Anforderungen)

Anforderung Wert
Version
Windows Installer 5.0 auf Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 auf Windows Server 2008 oder Windows Vista. Windows Installationsprogramm auf Windows Server 2003 oder Windows XP
DLL
Msi.dll
IID
IDatabase der IID ist als _ 000C109D-0000-0000-C000-00000000046 definiert.

Weitere Informationen

Datenbanktransformationen