参加リスト
リソース マネージャーは、その特定のトランザクションへの参加を開始するときに、トランザクションに参加します。 参加リストは、リソース マネージャーが受け入れる通知を定義します。 リソース マネージャーは、トランザクションに参加するときに参加オブジェクトを作成します。 このオブジェクトは、リソース マネージャー (RM) が指定されたトランザクションに関する通知を要求していることを KTM に通知します。
RM には、要求している通知を詳細に示す NOTIFICATION_MASK 構造が用意されています。
次の関数は、参加リストと共に使用されます。
機能 | 説明 |
---|---|
CommitComplete | リソース・マネージャー (RM) が、トランザクション・マネージャー (TM) によって要求されたトランザクションのコミットを完了したことを示します。 |
CreateEnlistment | 参加リストを作成し、その初期状態を設定し、指定されたアクセス権を持つ参加リストへのハンドルを開きます。 |
GetEnlistmentRecoveryInformation | KTM から回復データの不透明な構造を取得します。 回復情報は、 SetEnlistmentRecoveryInformation 関数を呼び出すことによって、リソース マネージャー (RM) に代わってログに格納されます。 エラーが発生した後、RM は GetEnlistmentRecoveryInformation 関数を使用して情報を取得できます。 |
OpenEnlistment | 既存の参加オブジェクトを開き、参加リストへのハンドルを返します。 |
ReadOnlyEnlistment | 指定した参加リストを読み取り専用の参加リストに変換するように要求します。 読み取り専用の参加リストはトランザクションの結果に参加できず、回復のために永続的に記録されません。 |
RollbackEnlistment | 参加リストに関連付けられている指定されたトランザクションをロールバックします。 この関数は、読み取り専用の参加リストには呼び出すことができません。 |
SetEnlistmentRecoveryInformation | KTM からの回復データの不透明なユーザー定義構造を設定します。 回復情報は、 SetEnlistmentRecoveryInformation を呼び出すことによって、リソース マネージャー (RM) に代わってログに格納されます。 エラーが発生した後、RM は GetEnlistmentRecoveryInformation を使用して情報を取得できます。 |
SinglePhaseReject | リソース・マネージャー (RM) が単一フェーズ要求を拒否していることを示します。 トランザクション マネージャー (TM) は、この呼び出しを受信すると、2 フェーズ コミットを開始し、参加しているすべての VM に準備要求を送信します。 |