CreateTransactionManager, fonction (ktmw32.h)
Crée un objet TM (Transaction Manager) 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 fichier journal. Si le flux n’existe pas dans le journal, il est créé. Pour créer une tm volatile, ce paramètre doit être NULL et CreateOptions devez 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 la tm est volatile et n’effectue pas de récupération. |
[in, optional] CommitStrength
Réservé; spécifiez zéro.
Valeur de retour
Si la fonction réussit, la valeur de retour est un handle du gestionnaire de transactions.
Si la fonction échoue, la valeur de retour est INVALID_HANDLE_VALUE. Pour obtenir des informations d’erreur étendues, appelez la fonction GetLastError.
La liste suivante identifie les codes d’erreur possibles :
Remarques
Immédiatement après avoir appelé 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 afin que le tm fonctionne correctement.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista |
| serveur minimum pris en charge | Windows Server 2008 |
| plateforme cible | Windows |
| d’en-tête | ktmw32.h |
| bibliothèque | Ktmw32.lib |
| DLL | Ktmw32.dll |