Transaction.EnlistDurable Méthode

Définition

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

Surcharges

EnlistDurable(Guid, IEnlistmentNotification, EnlistmentOptions)

Inscrit un gestionnaire de ressources durable qui prend en charge la 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)

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

Remarques

Remarque Cette méthode utilise LinkDemand pour l’empêcher d’être appelée à partir de code non fiable ; Toutefois, seul l’appelant immédiat est tenu de posséder FullTrust le 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)

Inscrit un gestionnaire de ressources durable qui prend en charge la 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

Identificateur unique pour un gestionnaire de ressources qui doit persister pendant une défaillance du gestionnaire de ressources ou un redémarrage.A unique identifier for a resource manager, which should persist across resource manager failure or reboot.

enlistmentNotification
IEnlistmentNotification

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

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

Les gestionnaires de ressources avec une inscription durable doivent être en mesure d’effectuer la récupération s’ils rencontrent une défaillance.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, voir 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 sur l’inscription d’une ressource, consultez implémentation d’un gestionnaire des 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 à la notification de validation et prépare la validation en deux phases, consultez validation d’une transaction en 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 listés pour la participation à une transaction via cette méthode reçoivent des notifications de validation à deux phases qui correspondent IEnlistmentNotification aux méthodes définies sur l’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)

Inscrit un gestionnaire de ressources durable qui prend en charge l'optimisation de la validation à phase unique pour participer à 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

Identificateur unique pour un gestionnaire de ressources qui doit persister pendant une défaillance du gestionnaire de ressources ou un redémarrage.A unique identifier for a resource manager, which should persist across resource manager failure or reboot.

singlePhaseNotification
ISinglePhaseNotification

Objet qui implémente l'interface ISinglePhaseNotification qui doit être capable 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

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

Les gestionnaires de ressources avec une inscription durable doivent être en mesure d’effectuer la récupération s’ils rencontrent une défaillance.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, voir 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 sur l’inscription d’une ressource, consultez implémentation d’un gestionnaire des ressources.For more information on volatile and durable resources, as well as how to enlist a resource, see Implementing A Resource Manager.

Notez que même lorsque votre implémentation de Resource Manager s’inscrit avec cette méthode, il n’est pas garanti qu’elle 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 en deux phases.The transaction manager can still send two phase commit notifications instead. Pour plus d’informations sur l’optimisation de la validation en une phase, consultez optimisation à l’aide de la validation à phase unique et de la 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 à