CreateTransactionManager, fonction (ktmw32.h)
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 |
---|---|
|
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 |