Partager via


Méthode Database.CreateTransformSummaryInfo

La méthode CreateTransformSummaryInfo de l’objet Database crée et remplit le flux d’informations récapitulatives d’un fichier de transformation existant. Cette méthode remplit les propriétés avec la base et la référence ProductCode et ProductVersion.

Syntaxe

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

Paramètres

reference

Base de données requise qui n’inclut pas les modifications.

storage

Le nom du fichier de transformation généré. Ce paramètre est facultatif.

errorConditions

Conditions d’erreur requises qui doivent être supprimées lorsque la transformation est appliquée. Combinez une ou plusieurs des valeurs de condition d’erreur suivantes.

Nom de la condition d’erreur Signification
msiTransformErrorNone
0
Aucune des conditions suivantes.
msiTransformErrorAddExistingRow
1
Ajoute une ligne déjà existante.
msiTransformErrorDeleteNonExistingRow
2
Supprime une ligne inexistante.
msiTransformErrorAddExistingTable
4
Ajoute une table déjà existante.
msiTransformErrorDeleteNonExistingTable
8
Supprime une table inexistante.
msiTransformErrorUpdateNonExistingRow
16
Met à jour une ligne inexistante.
msiTransformErrorChangeCodepage
32
Les pages de code de transformation et de base de données ne correspondent pas et aucune des pages de code n’est neutre.

validation

Obligatoire lorsque la transformation est appliquée à une base de données. Cela indique les propriétés qui doivent être validées pour vérifier que cette transformation peut être appliquée à la base de données. Les propriétés sont toutes contenues dans l’Ensemble de propriétés du flux d’informations récapitulatives.

Combinez une ou plusieurs des valeurs suivantes.

Indicateur de validation Signification
msiTransformValidationNone
0
Aucune validation effectuée.
msiTransformValidationLanguage
1
La langue par défaut doit correspondre à la base de données de base.
msiTransformValidationProduct
2
Le produit doit correspondre à la base de données de base.

Pour valider la version du produit, choisissez d’abord un ou plusieurs de ces trois indicateurs pour indiquer l’étendue de la version à vérifier.

Indicateur de validation Signification
msiTransformValidationMajorVer
8
Vérifie la version principale uniquement.
msiTransformValidationMinorVer
16
Vérifie uniquement les versions principales et mineures.
msiTransformValidationUpdateVer
32
Vérifie les versions principales, mineures et de mise à jour.

Choisissez ensuite l’une des options suivantes pour indiquer la relation requise entre la version de produit de la base de données à laquelle la transformation est appliquée et celle de la base de données de base.

Indicateur de validation Signification
msiTransformValidationLess
64
Version appliquée < version de base
msiTransformValidationLessOrEqual
128
Version appliquée <= version de base
msiTransformValidationEqual
256
Version appliquée = version de base
msiTransformValidationGreaterOrEqual
512
Version appliquée >= version de base
msiTransformValidationGreater
1 024
Version appliquée > version de base

Pour vérifier que la transformation est appliquée à un package ayant le UpgradeCode approprié, définissez l’indicateur suivant.

Indicateur de validation Signification
msiTransformValidationUpgradeCode
2 048
Vérifie que la transformation est le UpgradeCode approprié.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

Pour créer un flux d’informations récapitulatives pour une transformation, les propriétés ProductCode et ProductVersion doivent être définies dans les tables Property des bases de données de base et de référence. Si msiTransformValidationUpgradeCode est utilisé, la propriété UpgradeCode doit être définie dans les deux bases de données.

Configuration requise

Condition requise Valeur
Version
Windows Installer 5.0 sur Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 sur Windows Server 2008 ou Windows Vista. Windows Installer sur Windows Server 2003 ou Windows XP
DLL
Msi.dll
IID
IID_IDatabase est défini comme 000C109D-0000-0000-C000-000000000046

Voir aussi

Transformations de base de données