MsiDatabaseApplyTransformW, fonction (msiquery.h)
La fonction MsiDatabaseApplyTransform applique une transformation à une base de données.
Syntaxe
UINT MsiDatabaseApplyTransformW(
[in] MSIHANDLE hDatabase,
[in] LPCWSTR szTransformFile,
[in] int iErrorConditions
);
Paramètres
[in] hDatabase
Gérez la base de données obtenue à partir de MsiOpenDatabase pour la transformation.
[in] szTransformFile
Spécifie le nom du fichier de transformation à appliquer.
[in] iErrorConditions
Conditions d’erreur qui doivent être supprimées. Ce paramètre est un champ de bits qui peut contenir les bits suivants.
| État d’erreur | Signification |
|---|---|
|
Ajout d’une ligne déjà existante. |
|
Suppression d’une ligne inexistante. |
|
Ajout d’une table déjà existante. |
|
Suppression d’une table inexistante. |
|
Mise à jour d’une ligne inexistante. |
|
Les pages de code de transformation et de base de données ne correspondent pas et aucune n’a de page de code neutre. |
|
Créez la table _TransformView temporaire. |
Valeur retournée
La fonction MsiDatabaseApplyTransform retourne l’une des valeurs suivantes :
Notes
La fonction MsiDatabaseApplyTransform retarde la transformation des tables jusqu’à ce qu’elle soit nécessaire. Toutes les tables à ajouter ou à supprimer sont traitées immédiatement. Toutefois, les modifications apportées à la table existante sont retardées jusqu’à ce que la table soit chargée ou que la base de données soit validée.
Une erreur se produit si MsiDatabaseApplyTransform est appelé lorsque des tables ont déjà été chargées et enregistrées dans le stockage.
Étant donné que le délimiteur de liste pour les transformations, les sources et les correctifs est un point-virgule, ce caractère ne doit pas être utilisé pour les noms de fichiers ou les chemins d’accès.
Cette fonction ne peut pas être appelée à partir d’actions personnalisées. Un appel à cette fonction à partir d’une action personnalisée entraîne l’échec de la fonction.
Si la fonction échoue, vous pouvez obtenir des informations d’erreur étendues à l’aide de MsiGetLastErrorRecord.
Notes
L’en-tête msiquery.h définit MsiDatabaseApplyTransform comme un 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.
Spécifications
| Client minimal 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 |
| En-tête | msiquery.h |
| Bibliothèque | Msi.lib |
| DLL | Msi.dll |