Transaction.EnlistDurable Transaction.EnlistDurable Transaction.EnlistDurable Transaction.EnlistDurable Method

Définition

Inscrit un gestionnaire de ressources durables pour participer à une transaction.Enlists a durable resource manager to participate in a transaction.

Surcharges

EnlistDurable(Guid, IEnlistmentNotification, EnlistmentOptions) EnlistDurable(Guid, IEnlistmentNotification, EnlistmentOptions) EnlistDurable(Guid, IEnlistmentNotification, EnlistmentOptions) EnlistDurable(Guid, IEnlistmentNotification, EnlistmentOptions)

Inscrit un gestionnaire de ressources durable qui prend en charge de validation à deux phases pour participer à une transaction.Enlists a durable resource manager that supports two phase commit to participate in a transaction.

EnlistDurable(Guid, ISinglePhaseNotification, EnlistmentOptions) EnlistDurable(Guid, ISinglePhaseNotification, EnlistmentOptions) EnlistDurable(Guid, ISinglePhaseNotification, EnlistmentOptions) EnlistDurable(Guid, ISinglePhaseNotification, EnlistmentOptions)

Inscrit un gestionnaire de ressources durable qui prend en charge de phase unique optimisation de la validation dans une transaction.Enlists a durable resource manager that supports single phase commit optimization to participate in a transaction.

Remarques

Remarque utilise cette méthode LinkDemand pour empêcher qu’elle soit appelée à partir du code non approuvé ; Toutefois, il est nécessaire que l’appelant immédiat possède le FullTrust jeu d’autorisations.Note This method uses LinkDemand to prevent it from being called from untrusted code; however, only the immediate caller is required to possess the FullTrust permission set.

EnlistDurable(Guid, IEnlistmentNotification, EnlistmentOptions) EnlistDurable(Guid, IEnlistmentNotification, EnlistmentOptions) EnlistDurable(Guid, IEnlistmentNotification, EnlistmentOptions) EnlistDurable(Guid, IEnlistmentNotification, EnlistmentOptions)

Inscrit un gestionnaire de ressources durable qui prend en charge de validation à deux phases pour participer à une transaction.Enlists a durable resource manager that supports two phase commit to participate in a transaction.

public:
 System::Transactions::Enlistment ^ EnlistDurable(Guid manager, System::Transactions::IEnlistmentNotification ^ notification, System::Transactions::EnlistmentOptions options);
public System.Transactions.Enlistment EnlistDurable (Guid manager, System.Transactions.IEnlistmentNotification notification, System.Transactions.EnlistmentOptions options);
member this.EnlistDurable : Guid * System.Transactions.IEnlistmentNotification * System.Transactions.EnlistmentOptions -> System.Transactions.Enlistment
Public Function EnlistDurable (manager As Guid, notification As IEnlistmentNotification, options As EnlistmentOptions) As Enlistment

Paramètres

resourceManagerIdentifier
Guid Guid Guid Guid

Un identificateur unique pour un gestionnaire de ressources qui doit persister la défaillance du Gestionnaire de ressources ou du prochain redémarrage.A unique identifier for a resource manager, which should persist across resource manager failure or reboot.

enlistmentNotification
IEnlistmentNotification IEnlistmentNotification IEnlistmentNotification IEnlistmentNotification

Un objet qui implémente le IEnlistmentNotification interface pour recevoir des notifications de validation à deux phases.An object that implements the IEnlistmentNotification interface to receive two phase commit notifications.

enlistmentOptions
EnlistmentOptions EnlistmentOptions EnlistmentOptions EnlistmentOptions

EnlistDuringPrepareRequired si le gestionnaire de ressources souhaite exécuter un travail supplémentaire pendant la phase de préparation.EnlistDuringPrepareRequired if the resource manager wants to perform additional work during the prepare phase.

Retours

Un objet Enlistment qui décrit l'inscription.An Enlistment object that describes the enlistment.

Remarques

Gestionnaires de ressources avec une inscription durable doivent être en mesure d’effectuer la récupération s’ils rencontrent un échec.Resource managers with a durable enlistment must be able to perform recovery if they experience a failure. Pour plus d’informations sur la récupération, consultez exécution de la récupération.For more information on recovery, see Performing Recovery. Pour plus d’informations sur les ressources volatiles et durables, ainsi que comment inscrire une ressource, consultez implémentation d’un gestionnaire de ressources.For more information on volatile and durable resources, as well as how to enlist a resource, see Implementing A Resource Manager. Pour plus d’informations sur la façon dont un gestionnaire de ressources répond pour valider une notification et préparer la validation en deux phases, consultez valider une Transaction dans une phase unique et en plusieurs phases.For more information on how a resource manager responds to commit notification and prepare the commit in two-phase commit, see Committing A Transaction In Single-Phase and Multi-Phase.

Les gestionnaires de ressources inscrits pour participer à une transaction via cette méthode recevoir deux notifications de validation à phase qui correspondent aux méthodes définies sur le IEnlistmentNotification interface.Resource managers enlisted for participation in a transaction through this method receive two phase commit notifications that correspond to the methods defined on the IEnlistmentNotification interface.

EnlistDurable(Guid, ISinglePhaseNotification, EnlistmentOptions) EnlistDurable(Guid, ISinglePhaseNotification, EnlistmentOptions) EnlistDurable(Guid, ISinglePhaseNotification, EnlistmentOptions) EnlistDurable(Guid, ISinglePhaseNotification, EnlistmentOptions)

Inscrit un gestionnaire de ressources durable qui prend en charge de phase unique optimisation de la validation dans une transaction.Enlists a durable resource manager that supports single phase commit optimization to participate in a transaction.

public:
 System::Transactions::Enlistment ^ EnlistDurable(Guid manager, System::Transactions::ISinglePhaseNotification ^ notification, System::Transactions::EnlistmentOptions options);
public System.Transactions.Enlistment EnlistDurable (Guid manager, System.Transactions.ISinglePhaseNotification notification, System.Transactions.EnlistmentOptions options);
member this.EnlistDurable : Guid * System.Transactions.ISinglePhaseNotification * System.Transactions.EnlistmentOptions -> System.Transactions.Enlistment
Public Function EnlistDurable (manager As Guid, notification As ISinglePhaseNotification, options As EnlistmentOptions) As Enlistment

Paramètres

resourceManagerIdentifier
Guid Guid Guid Guid

Un identificateur unique pour un gestionnaire de ressources qui doit persister la défaillance du Gestionnaire de ressources ou du prochain redémarrage.A unique identifier for a resource manager, which should persist across resource manager failure or reboot.

singlePhaseNotification
ISinglePhaseNotification ISinglePhaseNotification ISinglePhaseNotification ISinglePhaseNotification

Un objet qui implémente le ISinglePhaseNotification interface qui doit être en mesure de recevoir une validation à phase unique et des notifications de validation à deux phases.An object that implements the ISinglePhaseNotification interface that must be able to receive single phase commit and two phase commit notifications.

enlistmentOptions
EnlistmentOptions EnlistmentOptions EnlistmentOptions EnlistmentOptions

EnlistDuringPrepareRequired si le gestionnaire de ressources souhaite exécuter un travail supplémentaire pendant la phase de préparation.EnlistDuringPrepareRequired if the resource manager wants to perform additional work during the prepare phase.

Retours

Un objet Enlistment qui décrit l'inscription.An Enlistment object that describes the enlistment.

Remarques

Gestionnaires de ressources avec une inscription durable doivent être en mesure d’effectuer la récupération s’ils rencontrent un échec.Resource managers with a durable enlistment must be able to perform recovery if they experience a failure. Pour plus d’informations sur la récupération, consultez exécution de la récupération.For more information on recovery, see Performing Recovery. Pour plus d’informations sur les ressources volatiles et durables, ainsi que comment inscrire une ressource, consultez implémentation d’un gestionnaire de ressources.For more information on volatile and durable resources, as well as how to enlist a resource, see Implementing A Resource Manager.

Vous devez noter que même lorsque votre implémentation de gestionnaire de ressources s’inscrit avec cette méthode, il n’est pas garanti qu’il reçoit une validation à phase unique.You should note that even when your resource manager implementation enlists with this method, it is not guaranteed that it receives a single phase commit. Le Gestionnaire de transactions peut toujours envoyer des notifications de validation à phase deux à la place.The transaction manager can still send two phase commit notifications instead. Pour plus d’informations sur l’optimisation de la validation en une seule phase, consultez optimisation à l’aide de Phase de validation et Notification de Phase unique pouvant être promue.For more information on the single phase commit optimization, see Optimization Using Single Phase Commit and Promotable Single Phase Notification.

S’applique à