Transaction.EnlistDurable メソッド

定義

トランザクションに参加する永続的リソース マネージャーを参加させます。Enlists a durable resource manager to participate in a transaction.

オーバーロード

EnlistDurable(Guid, IEnlistmentNotification, EnlistmentOptions)

2 フェーズ コミットをサポートし、トランザクションに参加する永続的リソース マネージャーを参加させます。Enlists a durable resource manager that supports two phase commit to participate in a transaction.

EnlistDurable(Guid, ISinglePhaseNotification, EnlistmentOptions)

単一フェーズ コミットの最適化をサポートし、トランザクションに参加する永続的リソース マネージャーを参加させます。Enlists a durable resource manager that supports single phase commit optimization to participate in a transaction.

注釈

メモこのメソッドは LinkDemand を使用して、信頼されていないコードから呼び出されないようにします。ただし、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)

2 フェーズ コミットをサポートし、トランザクションに参加する永続的リソース マネージャーを参加させます。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

パラメーター

resourceManagerIdentifier
Guid

リソース マネージャーのエラーの保持または再起動を必要とするリソース マネージャーの一意の識別子。A unique identifier for a resource manager, which should persist across resource manager failure or reboot.

enlistmentNotification
IEnlistmentNotification

2 フェーズ コミットの通知を受け取るために IEnlistmentNotification インターフェイスを実装するオブジェクト。An object that implements the IEnlistmentNotification interface to receive two phase commit notifications.

enlistmentOptions
EnlistmentOptions

リソース マネージャーが、準備フェーズ中に追加の処理を実行する場合 EnlistDuringPrepareRequiredEnlistDuringPrepareRequired if the resource manager wants to perform additional work during the prepare phase.

戻り値

参加リストについて記述している Enlistmentオブジェクト。An Enlistment object that describes the enlistment.

注釈

持続性のある参加リストを持つリソースマネージャーは、障害が発生した場合に回復を実行できる必要があります。Resource managers with a durable enlistment must be able to perform recovery if they experience a failure. 回復の詳細については、「回復の実行」を参照してください。For more information on recovery, see Performing Recovery. 揮発性リソースと持続性のあるリソースの詳細、およびリソースの参加方法については、「リソースマネージャーの実装」を参照してください。For more information on volatile and durable resources, as well as how to enlist a resource, see Implementing A Resource Manager. リソースマネージャーがコミット通知に応答し、2フェーズコミットでコミットを準備する方法の詳細については、「単一フェーズおよび複数フェーズでのトランザクションのコミット」を参照してください。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.

このメソッドを使用してトランザクションに参加するために参加しているリソースマネージャーは、IEnlistmentNotification インターフェイスに定義されているメソッドに対応する2フェーズコミット通知を受け取ります。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)

単一フェーズ コミットの最適化をサポートし、トランザクションに参加する永続的リソース マネージャーを参加させます。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

パラメーター

resourceManagerIdentifier
Guid

リソース マネージャーのエラーの保持または再起動を必要とするリソース マネージャーの一意の識別子。A unique identifier for a resource manager, which should persist across resource manager failure or reboot.

singlePhaseNotification
ISinglePhaseNotification

ISinglePhaseNotification インターフェイスを実装し、単一フェーズ コミットと 2 フェーズ コミットの通知を受け取ることができる必要のあるオブジェクト。An object that implements the ISinglePhaseNotification interface that must be able to receive single phase commit and two phase commit notifications.

enlistmentOptions
EnlistmentOptions

リソース マネージャーが、準備フェーズ中に追加の処理を実行する場合 EnlistDuringPrepareRequiredEnlistDuringPrepareRequired if the resource manager wants to perform additional work during the prepare phase.

戻り値

参加リストについて記述している Enlistmentオブジェクト。An Enlistment object that describes the enlistment.

注釈

持続性のある参加リストを持つリソースマネージャーは、障害が発生した場合に回復を実行できる必要があります。Resource managers with a durable enlistment must be able to perform recovery if they experience a failure. 回復の詳細については、「回復の実行」を参照してください。For more information on recovery, see Performing Recovery. 揮発性リソースと持続性のあるリソースの詳細、およびリソースの参加方法については、「リソースマネージャーの実装」を参照してください。For more information on volatile and durable resources, as well as how to enlist a resource, see Implementing A Resource Manager.

Resource manager の実装がこのメソッドに参加している場合でも、1つのフェーズコミットを受信する保証はないことに注意してください。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. トランザクションマネージャーは、代わりに2フェーズコミット通知を送信できます。The transaction manager can still send two phase commit notifications instead. 単一フェーズコミットの最適化の詳細については、「単一フェーズコミットを使用した最適化」と「昇格可能な単一フェーズ通知」を参照してください。For more information on the single phase commit optimization, see Optimization Using Single Phase Commit and Promotable Single Phase Notification.

適用対象