Transaction.EnlistDurable Método

Definição

Inscreve um Resource Manager durável para participar de uma transação.Enlists a durable resource manager to participate in a transaction.

Sobrecargas

EnlistDurable(Guid, IEnlistmentNotification, EnlistmentOptions)

Inscreve um gerenciador de recursos durável que dá suporte à confirmação em duas fases para participar de uma transação.Enlists a durable resource manager that supports two phase commit to participate in a transaction.

EnlistDurable(Guid, ISinglePhaseNotification, EnlistmentOptions)

Inscreve um Resource Manager durável que dá suporte à otimização em fase única para participar de uma transação.Enlists a durable resource manager that supports single phase commit optimization to participate in a transaction.

Comentários

Observação Esse método usa LinkDemand para impedir que ele seja chamado de código não confiável; no entanto, somente o chamador imediato precisa ter o conjunto de permissões FullTrust.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)

Inscreve um gerenciador de recursos durável que dá suporte à confirmação em duas fases para participar de uma transação.Enlists a durable resource manager that supports two phase commit to participate in a transaction.

public:
 System::Transactions::Enlistment ^ EnlistDurable(Guid resourceManagerIdentifier, System::Transactions::IEnlistmentNotification ^ enlistmentNotification, System::Transactions::EnlistmentOptions enlistmentOptions);
public:
 System::Transactions::Enlistment ^ EnlistDurable(Guid manager, System::Transactions::IEnlistmentNotification ^ notification, System::Transactions::EnlistmentOptions options);
public System.Transactions.Enlistment EnlistDurable (Guid resourceManagerIdentifier, System.Transactions.IEnlistmentNotification enlistmentNotification, System.Transactions.EnlistmentOptions enlistmentOptions);
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
member this.EnlistDurable : Guid * System.Transactions.IEnlistmentNotification * System.Transactions.EnlistmentOptions -> System.Transactions.Enlistment
Public Function EnlistDurable (resourceManagerIdentifier As Guid, enlistmentNotification As IEnlistmentNotification, enlistmentOptions As EnlistmentOptions) As Enlistment
Public Function EnlistDurable (manager As Guid, notification As IEnlistmentNotification, options As EnlistmentOptions) As Enlistment

Parâmetros

resourceManagerIdentifiermanager
Guid

’Um identificador exclusivo de um gerenciador de recursos, que deve persistir durante uma falha ou reinicialização do gerenciador de recursos.A unique identifier for a resource manager, which should persist across resource manager failure or reboot.

enlistmentNotificationnotification
IEnlistmentNotification

Um objeto que implementa a interface IEnlistmentNotification para receber duas notificações de confirmação de fase.An object that implements the IEnlistmentNotification interface to receive two phase commit notifications.

enlistmentOptionsoptions
EnlistmentOptions

EnlistDuringPrepareRequired se o gerenciador de recursos desejar realizar trabalho adicional durante a fase de preparação.EnlistDuringPrepareRequired if the resource manager wants to perform additional work during the prepare phase.

Retornos

Enlistment

Um objeto Enlistment que descreve a inscrição.An Enlistment object that describes the enlistment.

Comentários

Os gerenciadores de recursos com uma inscrição durável devem ser capazes de executar a recuperação se ocorrerem uma falha.Resource managers with a durable enlistment must be able to perform recovery if they experience a failure. Para obter mais informações sobre recuperação, consulte executando a recuperação.For more information on recovery, see Performing Recovery. Para obter mais informações sobre os recursos voláteis e duráveis, bem como para inscrever um recurso, consulte implementando um Gerenciador de recursos.For more information on volatile and durable resources, as well as how to enlist a resource, see Implementing A Resource Manager. Para obter mais informações sobre como um Gerenciador de recursos responde à notificação de confirmação e prepara a confirmação na confirmação em duas fases, consulte confirmando uma transação em fase única e várias fases.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.

Os gerenciadores de recursos inscritos para a participação em uma transação por esse método recebem duas notificações de confirmação de fase que correspondem aos métodos definidos na interface IEnlistmentNotification.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)

Inscreve um Resource Manager durável que dá suporte à otimização em fase única para participar de uma transação.Enlists a durable resource manager that supports single phase commit optimization to participate in a transaction.

public:
 System::Transactions::Enlistment ^ EnlistDurable(Guid resourceManagerIdentifier, System::Transactions::ISinglePhaseNotification ^ singlePhaseNotification, System::Transactions::EnlistmentOptions enlistmentOptions);
public:
 System::Transactions::Enlistment ^ EnlistDurable(Guid manager, System::Transactions::ISinglePhaseNotification ^ notification, System::Transactions::EnlistmentOptions options);
public System.Transactions.Enlistment EnlistDurable (Guid resourceManagerIdentifier, System.Transactions.ISinglePhaseNotification singlePhaseNotification, System.Transactions.EnlistmentOptions enlistmentOptions);
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
member this.EnlistDurable : Guid * System.Transactions.ISinglePhaseNotification * System.Transactions.EnlistmentOptions -> System.Transactions.Enlistment
Public Function EnlistDurable (resourceManagerIdentifier As Guid, singlePhaseNotification As ISinglePhaseNotification, enlistmentOptions As EnlistmentOptions) As Enlistment
Public Function EnlistDurable (manager As Guid, notification As ISinglePhaseNotification, options As EnlistmentOptions) As Enlistment

Parâmetros

resourceManagerIdentifiermanager
Guid

’Um identificador exclusivo de um gerenciador de recursos, que deve persistir durante uma falha ou reinicialização do gerenciador de recursos.A unique identifier for a resource manager, which should persist across resource manager failure or reboot.

singlePhaseNotificationnotification
ISinglePhaseNotification

Um objeto que implementa a interface ISinglePhaseNotification, a qual deve ser capaz de receber notificações de confirmação em uma e em duas fases.An object that implements the ISinglePhaseNotification interface that must be able to receive single phase commit and two phase commit notifications.

enlistmentOptionsoptions
EnlistmentOptions

EnlistDuringPrepareRequired se o gerenciador de recursos desejar realizar trabalho adicional durante a fase de preparação.EnlistDuringPrepareRequired if the resource manager wants to perform additional work during the prepare phase.

Retornos

Enlistment

Um objeto Enlistment que descreve a inscrição.An Enlistment object that describes the enlistment.

Comentários

Os gerenciadores de recursos com uma inscrição durável devem ser capazes de executar a recuperação se ocorrerem uma falha.Resource managers with a durable enlistment must be able to perform recovery if they experience a failure. Para obter mais informações sobre recuperação, consulte executando a recuperação.For more information on recovery, see Performing Recovery. Para obter mais informações sobre os recursos voláteis e duráveis, bem como para inscrever um recurso, consulte implementando um Gerenciador de recursos.For more information on volatile and durable resources, as well as how to enlist a resource, see Implementing A Resource Manager.

Você deve observar que mesmo quando a implementação do Resource Manager se registrar com esse método, não há garantia de que ele receba uma única confirmação de fase.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. Em vez disso, o Gerenciador de transações ainda pode enviar duas notificações de confirmação de fase.The transaction manager can still send two phase commit notifications instead. Para obter mais informações sobre a otimização de confirmação de fase única, consulte otimização usando confirmação de fase única e notificação de fase única de promoçãotable.For more information on the single phase commit optimization, see Optimization Using Single Phase Commit and Promotable Single Phase Notification.

Aplica-se a