MsiBeginTransactionA, fonction (msi.h)

Article
11/20/2024

La fonction MsiBeginTransaction démarre traitement des transactions d’une installation à plusieurs packages et retourne un identificateur pour la transaction. La fonction MsiEndTransaction met fin à 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 MsiBeginTransactionA(
  [in]  LPCSTR    szName,
  [in]  DWORD     dwTransactionAttributes,
  [out] MSIHANDLE *phTransactionHandle,
  [out] HANDLE    *phChangeOfOwnerEvent
);

Paramètres

[in] szName

Nom de l’installation à plusieurs packages.

[in] dwTransactionAttributes

Attributs de l’installation de plusieurs packages.

Valeur	Signification
0	Quand 0 ou aucune valeur n’est définie, Windows Installer ferme l’interface utilisateur de l’installation précédente.
MSITRANSACTION_CHAIN_EMBEDDEDUI	Définissez cet attribut pour demander que Windows Installer n’arrête pas l’interface utilisateur incorporée tant que la transaction n’est pas terminée.

[out] phTransactionHandle

L’ID de transaction est une valeur MSIHANDLE qui identifie la transaction. Un seul processus peut posséder une transaction à la fois.

[out] phChangeOfOwnerEvent

Ce paramètre retourne un handle à un événement défini lorsque la fonction MsiJoinTransaction remplace le propriétaire de la transaction par un nouveau propriétaire. Le propriétaire actuel peut l’utiliser pour déterminer quand la propriété de la transaction a changé. La sortie d’une transaction sans propriétaire restaure la transaction.

Valeur de retour

La fonction MsiBeginTransaction retourne les valeurs suivantes.

Valeur	Signification
ERROR_INSTALL_SERVICE_FAILURE	Impossible d’accéder au service d’installation. Cette fonction nécessite le service Windows Installer.
ERROR_INSTALL_ALREADY_RUNNING	Une seule transaction peut être ouverte sur un système à la fois. La fonction retourne cette erreur si elle est appelée pendant l’exécution d’une autre transaction.
ERROR_INVALID_PARAMETER	Un paramètre non valide est passé à la fonction.
ERROR_ROLLBACK_DISABLED	'installation de restauration ont été désactivées par la propriété DISABLEROLLBACK ou stratégie de DisableRollback.

Remarques

Note

L’en-tête msi.h définit MsiBeginTransaction en tant qu’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.5 sur Windows Vista, Windows XP, Windows Server 2003 et Windows Server 2008. Consultez la configuration requise de Windows Installer Run-Time pour plus d’informations sur le service pack Windows minimal requis par une version de Windows Installer.
plateforme cible	Windows
d’en-tête	msi.h
bibliothèque	Msi.lib
DLL	Msi.dll

Voir aussi

plusieurs installations de package

Partager via