Partager via


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
MSITRANSACTIONSTATE_ROLLBACK
Effectue une installation de restauration pour annuler les modifications apportées au système appartenant à la transaction ouverte par la fonction MsiBeginTransaction .
MSITRANSACTIONSTATE_COMMIT
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
ERROR_ACCESS_DENIED
Une transaction peut être terminée uniquement par le propriétaire actuel.
ERROR_INSTALL_FAILURE
Impossible d’effectuer une installation appartenant à la transaction.
ERROR_INSTALL_ALREADY_RUNNING
Une installation appartenant à la transaction est toujours en cours.
ERROR_ROLLBACK_DISABLED
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

Voir aussi

Installations de plusieurs packages