CreateTransactionManager, fonction (ktmw32.h)

  • Article

Crée un objet Gestionnaire de transactions (TM) et retourne un handle avec l’accès spécifié.

Syntaxe

HANDLE CreateTransactionManager(
  [in, optional] LPSECURITY_ATTRIBUTES lpTransactionAttributes,
  [in, optional] LPWSTR                LogFileName,
  [in, optional] ULONG                 CreateOptions,
  [in, optional] ULONG                 CommitStrength
);

Paramètres

[in, optional] lpTransactionAttributes

Transaction SECURITY_ATTRIBUTES (ACL) pour l’objet TM.

[in, optional] LogFileName

Nom du flux de fichiers journaux. Si le flux n’existe pas dans le journal, il est créé. Pour créer un tm volatile, ce paramètre doit avoir la valeur NULL et CreateOptions doit spécifier TRANSACTION_MANAGER_VOLATILE, ce gestionnaire de transactions est considéré comme volatile.

[in, optional] CreateOptions

Tous les attributs facultatifs pour la nouvelle TM.

Valeur Signification
TRANSACTION_MANAGER_VOLATILE
 Indique que le TM est volatile et n’effectue pas de récupération.

[in, optional] CommitStrength

Réservés au; spécifiez zéro.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle pour le gestionnaire de transactions.

Si la fonction échoue, la valeur de retour est INVALID_HANDLE_VALUE. Pour obtenir des informations détaillées sur l’erreur, appelez la fonction GetLastError.

La liste suivante identifie les codes d’erreur possibles :

Remarques

Immédiatement après l’appel de cette fonction, vous devez appeler RecoverTransactionManager.

Si votre gestionnaire de transactions est volatile, tous vos gestionnaires de ressources doivent également être volatiles.

Vous devez appeler RecoverTransactionManager après avoir créé une TM pour que la TM fonctionne correctement.

Configuration requise

   
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2008
Plateforme cible Windows
En-tête ktmw32.h
Bibliothèque Ktmw32.lib
DLL Ktmw32.dll

Voir aussi

Fonctions du gestionnaire de transactions du noyau

OpenTransactionManager

RecoverTransactionManager

SECURITY_ATTRIBUTES