Transaction.EnlistDurable メソッド

定義

トランザクションに参加する永続的リソース マネージャーを参加させます。

オーバーロード

EnlistDurable(Guid, IEnlistmentNotification, EnlistmentOptions)

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

EnlistDurable(Guid, ISinglePhaseNotification, EnlistmentOptions)

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

注釈

注意

このメソッドは を使用 LinkDemand して、信頼されていないコードから呼び出されないようにします。ただし、アクセス許可セットを所有 FullTrust するために必要なのは、直接呼び出し元だけです。

EnlistDurable(Guid, IEnlistmentNotification, EnlistmentOptions)

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

public:
 System::Transactions::Enlistment ^ EnlistDurable(Guid resourceManagerIdentifier, System::Transactions::IEnlistmentNotification ^ enlistmentNotification, System::Transactions::EnlistmentOptions enlistmentOptions);
public System.Transactions.Enlistment EnlistDurable (Guid resourceManagerIdentifier, System.Transactions.IEnlistmentNotification enlistmentNotification, System.Transactions.EnlistmentOptions enlistmentOptions);
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

パラメーター

resourceManagerIdentifier
Guid

リソース マネージャーのエラーの保持または再起動を必要とするリソース マネージャーの一意の識別子。

enlistmentNotification
IEnlistmentNotification

2 フェーズ コミットの通知を受け取るために IEnlistmentNotification インターフェイスを実装するオブジェクト。

enlistmentOptions
EnlistmentOptions

リソース マネージャーが、準備フェーズ中に追加の処理を実行する場合 EnlistDuringPrepareRequired

戻り値

参加リストについて記述している Enlistmentオブジェクト。

注釈

永続参加リストを持つリソース マネージャーは、障害が発生した場合に回復を実行できる必要があります。 回復の詳細については、「回復の実行」を参照してください。 揮発性および持続性のあるリソースの詳細と、リソースに参加する方法については、「Resource Managerの実装」を参照してください。 リソース マネージャーがコミット通知に応答し、2 フェーズコミットでコミットを準備する方法の詳細については、「 Single-Phaseおよびマルチフェーズでのトランザクションのコミット」を参照してください。

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

適用対象

EnlistDurable(Guid, ISinglePhaseNotification, EnlistmentOptions)

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

public:
 System::Transactions::Enlistment ^ EnlistDurable(Guid resourceManagerIdentifier, System::Transactions::ISinglePhaseNotification ^ singlePhaseNotification, System::Transactions::EnlistmentOptions enlistmentOptions);
public System.Transactions.Enlistment EnlistDurable (Guid resourceManagerIdentifier, System.Transactions.ISinglePhaseNotification singlePhaseNotification, System.Transactions.EnlistmentOptions enlistmentOptions);
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

パラメーター

resourceManagerIdentifier
Guid

リソース マネージャーのエラーの保持または再起動を必要とするリソース マネージャーの一意の識別子。

singlePhaseNotification
ISinglePhaseNotification

ISinglePhaseNotification インターフェイスを実装し、単一フェーズ コミットと 2 フェーズ コミットの通知を受け取ることができる必要のあるオブジェクト。

enlistmentOptions
EnlistmentOptions

リソース マネージャーが、準備フェーズ中に追加の処理を実行する場合 EnlistDuringPrepareRequired

戻り値

参加リストについて記述している Enlistmentオブジェクト。

注釈

永続参加リストを持つリソース マネージャーは、障害が発生した場合に回復を実行できる必要があります。 回復の詳細については、「回復の実行」を参照してください。 揮発性および持続性のあるリソースの詳細と、リソースに参加する方法については、「Resource Managerの実装」を参照してください。

リソース マネージャーの実装がこのメソッドに参加する場合でも、単一フェーズコミットを受け取る保証はされないことに注意してください。 トランザクション マネージャーは、代わりに 2 つのフェーズ コミット通知を送信できます。 単一フェーズ コミットの最適化の詳細については、「 単一フェーズ コミットを使用した最適化」と「昇格可能な単一フェーズ通知」を参照してください。

適用対象