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

Definition

Trägt einen permanenten Ressourcen-Manager ein, der an einer Transaktion beteiligt sein soll.Enlists a durable resource manager to participate in a transaction.

Überlädt

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

Trägt einen permanenten Ressourcen-Manager ein, der das Zwei-Phasen-Commit unterstützt und an einer Transaktion beteiligt sein soll.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)

Trägt einen permanenten Ressourcen-Manager ein, der das Optimieren eines Ein-Phasen-Commits unterstützt und an einer Transaktion beteiligt sein soll.Enlists a durable resource manager that supports single phase commit optimization to participate in a transaction.

Hinweise

Hinweis Diese Methode verwendet LinkDemand , um zu verhindern, dass Sie von nicht vertrauenswürdigem Code aufgerufen wird. es ist jedoch nur für den FullTrust unmittelbaren Aufrufer erforderlich, den Berechtigungs Satz zu besitzen.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)

Trägt einen permanenten Ressourcen-Manager ein, der das Zwei-Phasen-Commit unterstützt und an einer Transaktion beteiligt sein soll.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

Parameter

resourceManagerIdentifier
Guid Guid Guid Guid

Ein eindeutiger Bezeichner für einen Ressourcen-Manager, der bei einem Fehler oder Neustart des Ressourcen-Managers erhalten bleiben soll.A unique identifier for a resource manager, which should persist across resource manager failure or reboot.

enlistmentNotification
IEnlistmentNotification IEnlistmentNotification IEnlistmentNotification IEnlistmentNotification

Ein Objekt, das die IEnlistmentNotification-Schnittstelle implementiert, um Benachrichtigungen über Zwei-Phasen-Commits zu empfangen.An object that implements the IEnlistmentNotification interface to receive two phase commit notifications.

enlistmentOptions
EnlistmentOptions EnlistmentOptions EnlistmentOptions EnlistmentOptions

EnlistDuringPrepareRequired, wenn der Ressourcen-Manager während der Vorbereitungsphase zusätzliche Arbeiten ausführen möchte.EnlistDuringPrepareRequired if the resource manager wants to perform additional work during the prepare phase.

Gibt zurück

Ein Enlistment-Objekt, das die Eintragung beschreibt.An Enlistment object that describes the enlistment.

Hinweise

Ressourcen-Manager mit einer permanenten Eintragung müssen in der Lage sein, eine Wiederherstellung auszuführen, wenn ein Fehler auftritt.Resource managers with a durable enlistment must be able to perform recovery if they experience a failure. Weitere Informationen zur Wiederherstellung finden Sie unter Durchführen der Wiederherstellung.For more information on recovery, see Performing Recovery. Weitere Informationen zu flüchtigen und permanenten Ressourcen sowie zum Eintragen einer Ressource finden Sie unter Implementieren einer Ressourcen-Manager.For more information on volatile and durable resources, as well as how to enlist a resource, see Implementing A Resource Manager. Weitere Informationen dazu, wie ein Ressourcen-Manager auf die Commit-Benachrichtigung antwortet und den Commit in Zweiphasencommit vorbereitet, finden Sie unter Commit a Transaction in Single-Phase and Multi-Phase.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.

Ressourcen-Manager, die über diese Methode für die Teilnahme an einer Transaktion eingetragen werden, empfangen zwei Phasen-Commit-Benachrichtigungen IEnlistmentNotification , die den für die Schnittstelle definierten Methoden entsprechen.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)

Trägt einen permanenten Ressourcen-Manager ein, der das Optimieren eines Ein-Phasen-Commits unterstützt und an einer Transaktion beteiligt sein soll.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

Parameter

resourceManagerIdentifier
Guid Guid Guid Guid

Ein eindeutiger Bezeichner für einen Ressourcen-Manager, der bei einem Fehler oder Neustart des Ressourcen-Managers erhalten bleiben soll.A unique identifier for a resource manager, which should persist across resource manager failure or reboot.

singlePhaseNotification
ISinglePhaseNotification ISinglePhaseNotification ISinglePhaseNotification ISinglePhaseNotification

Ein Objekt, das die ISinglePhaseNotification-Schnittstelle implementiert, die für den Empfang von Benachrichtigungen über Ein- und Zwei-Phasen-Commits geeignet sein muss.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, wenn der Ressourcen-Manager während der Vorbereitungsphase zusätzliche Arbeiten ausführen möchte.EnlistDuringPrepareRequired if the resource manager wants to perform additional work during the prepare phase.

Gibt zurück

Ein Enlistment-Objekt, das die Eintragung beschreibt.An Enlistment object that describes the enlistment.

Hinweise

Ressourcen-Manager mit einer permanenten Eintragung müssen in der Lage sein, eine Wiederherstellung auszuführen, wenn ein Fehler auftritt.Resource managers with a durable enlistment must be able to perform recovery if they experience a failure. Weitere Informationen zur Wiederherstellung finden Sie unter Durchführen der Wiederherstellung.For more information on recovery, see Performing Recovery. Weitere Informationen zu flüchtigen und permanenten Ressourcen sowie zum Eintragen einer Ressource finden Sie unter Implementieren einer Ressourcen-Manager.For more information on volatile and durable resources, as well as how to enlist a resource, see Implementing A Resource Manager.

Beachten Sie, dass es auch dann, wenn Ihre Resource Manager-Implementierung mit dieser Methode eingetragen wird, nicht garantiert wird, dass Sie ein einzelnes Phasen-Commit empfängt.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. Der Transaktions-Manager kann stattdessen immer noch zwei Phasen-Commit-Benachrichtigungen senden.The transaction manager can still send two phase commit notifications instead. Weitere Informationen zu den einzelnen Phasen-Commit-Optimierungen finden Sie unter Optimierung mit Einphasencommit und heraufstufbarer Einphasenbenachrichtigung.For more information on the single phase commit optimization, see Optimization Using Single Phase Commit and Promotable Single Phase Notification.

Gilt für: