MsiCreateTransformSummaryInfoA, fonction (msiquery.h)

Article
11/20/2024

La fonction MsiCreateTransformSummaryInfo crée des informations récapitulatives d’une transformation existante pour inclure des conditions de validation et d’erreur. L’exécution de cette fonction définit l’enregistrement d’erreur, accessible à l’aide de MsiGetLastErrorRecord.

Syntaxe

UINT MsiCreateTransformSummaryInfoA(
  [in] MSIHANDLE hDatabase,
  [in] MSIHANDLE hDatabaseReference,
  [in] LPCSTR    szTransformFile,
  [in] int       iErrorConditions,
  [in] int       iValidation
);

Paramètres

[in] hDatabase

Handle de la base de données qui contient les nouvelles informations récapitulatives de base de données.

[in] hDatabaseReference

Handle de la base de données qui contient les informations récapitulatives d’origine.

[in] szTransformFile

Nom de la transformation à laquelle les informations récapitulatives sont ajoutées.

[in] iErrorConditions

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

Condition d’erreur	Signification
aucun 0x00000000	Aucune des conditions suivantes.
MSITRANSFORM_ERROR_ADDEXISTINGROW 0x00000001	Ajout d’une ligne qui existe.
MSITRANSFORM_ERROR_DELMISSINGROW 0x00000002	Suppression d’une ligne qui n’existe pas.
MSITRANSFORM_ERROR_ADDEXISTINGTABLE 0x00000004	Ajout d’une table qui existe.
MSITRANSFORM_ERROR_DELMISSINGTABLE 0x00000008	Suppression d’une table qui n’existe pas.
MSITRANSFORM_ERROR_UPDATEMISSINGROW 0x00000010	Mise à jour d’une ligne qui n’existe pas.
MSITRANSFORM_ERROR_CHANGECODEPAGE 0x00000020	Les pages de codes de transformation et de base de données ne correspondent pas, et leurs pages de codes sont neutres.

[in] iValidation

Spécifie les propriétés à valider pour vérifier que la transformation peut être appliquée à la base de données. Ce paramètre peut être une ou plusieurs des valeurs suivantes.

Indicateur de validation	Signification
aucun 0x00000000	Ne validez pas les propriétés.
MSITRANSFORM_VALIDATE_LANGUAGE 0x00000001	La langue par défaut doit correspondre à la base de données de base.
MSITRANSFORM_VALIDATE_PRODUCT 0x00000002	Le produit doit correspondre à la base de données de base.

Valider les indicateurs de version du produit.

Indicateur de validation	Signification
MSITRANSFORM_VALIDATE_MAJORVERSION 0x00000008	Vérifiez uniquement la version principale.
MSITRANSFORM_VALIDATE_MINORVERSION 0x00000010	Vérifiez uniquement les versions principales et mineures.
MSITRANSFORM_VALIDATE_UPDATEVERSION 0x00000020	Vérifiez les versions principales, mineures et mises à jour.

Indicateurs de relation de version de produit. Dans le tableau suivant, la version installée est la version du package en cours de transformation, et la version de base est la version du package utilisée pour créer la transformation.

Indicateur de validation	Signification
MSITRANSFORM_VALIDATE_NEWLESSBASEVERSION 0x00000040	Version installée < version de base.
MSITRANSFORM_VALIDATE_NEWLESSEQUALBASEVERSION 0x00000080	Version installée <= version de base.
MSITRANSFORM_VALIDATE_NEWEQUALBASEVERSION 0x00000100	Version installée = version de base.
MSITRANSFORM_VALIDATE_NEWGREATEREQUALBASEVERSION 0x00000200	Version installée >= version de base.
MSITRANSFORM_VALIDATE_NEWGREATERBASEVERSION 0x00000400	Version installée > version de base.

Mettre à niveau des indicateurs de validation de code.

Indicateur de validation	Signification
MSITRANSFORM_VALIDATE_UPGRADECODE 0x00000800	UpgradeCode doit correspondre à la base de données de base.

Valeur de retour

Cette fonction retourne UINT.

Remarques

La propriété ProductCode et la propriété ProductVersion doivent être définies dans la table de propriétés des bases de données de base et de référence. Si MSITRANSFORM_VALIDATE_UPGRADECODE est utilisé, la UpgradeCode Property doit également être définie dans les deux bases de données. Si ces conditions ne sont pas remplies, MsiCreateTransformSummaryInfo retourne ERROR_INSTALL_PACKAGE_INVALID.

N’utilisez pas le point-virgule pour les noms de fichiers ou les chemins d’accès, car il est utilisé comme délimiteur de liste pour les transformations, les sources et les correctifs.
Cette fonction ne peut pas être appelée à partir d’actions personnalisées. Un appel à cette fonction à partir d’une action personnalisée provoque l’échec de la fonction.

Note

L’en-tête msiquery.h définit MsiCreateTransformSummaryInfo comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	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
plateforme cible	Windows
d’en-tête	msiquery.h
bibliothèque	Msi.lib
DLL	Msi.dll

Voir aussi

transformations de base de données

ensemble de propriétés de flux d’informations récapitulatives

Partager via