MsiEndTransaction, fonction (msi.h)
La fonction MsiEndTransaction peut valider ou restaurer toutes les installations appartenant à la transaction ouverte par la fonction MsiBeginTransaction . Cette fonction doit être appelée par le propriétaire actuel de la transaction.
Windows Installer 4.0 et versions antérieures : Non pris en charge. Cette fonction est disponible à partir de Windows Installer 4.5.
Syntaxe
UINT MsiEndTransaction(
[in] DWORD dwTransactionState
);
Paramètres
[in] dwTransactionState
La valeur de ce paramètre détermine si le programme d’installation valide ou restaure toutes les installations appartenant à la transaction. La valeur peut être l’une des suivantes.
| Valeur | Signification |
|---|---|
|
Effectue une installation de restauration pour annuler les modifications apportées au système appartenant à la transaction ouverte par la fonction MsiBeginTransaction . |
|
Valide toutes les modifications apportées au système appartenant à la transaction. Exécute toutes les actions personnalisées de validation et valide dans le système toutes les modifications apportées aux assemblys Win32 ou common language runtime. Supprime le script de restauration et, après avoir utilisé cette option, les modifications de la transaction ne peuvent plus être annulées avec une installation de restauration. |
Valeur retournée
La fonction MsiEndTransaction retourne les valeurs suivantes.
| Valeur | Signification |
|---|---|
|
Une transaction peut être terminée uniquement par le propriétaire actuel. |
|
Impossible d’effectuer une installation appartenant à la transaction. |
|
Une installation appartenant à la transaction est toujours en cours. |
|
Une installation appartenant à la transaction n’a pas été terminée. Pendant l’installation, l’action DésactiverRollback a désactivé les installations de restauration du package. Le programme d’installation restaure l’installation jusqu’au point où la restauration a été désactivée, et la fonction retourne cette erreur. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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.5 sur Windows Vista, Windows XP, Windows Server 2003 et Windows Server 2008. Pour plus d’informations sur le Service Pack Windows requis par une version de Windows Installer, consultez Configuration requise pour le runtime Windows. |
| Plateforme cible | Windows |
| En-tête | msi.h |
| Bibliothèque | Msi.lib |
| DLL | Msi.dll |