Freigeben über


Transaction.EnlistPromotableSinglePhase Methode

Definition

Enlists a resource manager that has an internal transaction using a promotable single phase enlistment (PSPE).

Überlädt

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification)

Enlists a resource manager that has an internal transaction using a promotable single phase enlistment (PSPE).

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification, Guid)

Enlists a resource manager that has an internal transaction using a promotable single phase enlistment (PSPE).

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification)

Quelle:
Transaction.cs
Quelle:
Transaction.cs
Quelle:
Transaction.cs

Enlists a resource manager that has an internal transaction using a promotable single phase enlistment (PSPE).

public:
 bool EnlistPromotableSinglePhase(System::Transactions::IPromotableSinglePhaseNotification ^ promotableSinglePhaseNotification);
public bool EnlistPromotableSinglePhase (System.Transactions.IPromotableSinglePhaseNotification promotableSinglePhaseNotification);
member this.EnlistPromotableSinglePhase : System.Transactions.IPromotableSinglePhaseNotification -> bool
Public Function EnlistPromotableSinglePhase (promotableSinglePhaseNotification As IPromotableSinglePhaseNotification) As Boolean

Parameter

promotableSinglePhaseNotification
IPromotableSinglePhaseNotification

Eine vom Teilnehmer implementierte IPromotableSinglePhaseNotification Schnittstelle.

Gibt zurück

Eine SinglePhaseEnlistment Schnittstellenimplementierung, die die Einlistung beschreibt.

Hinweise

Listen in einer Transaktion sind veränderlich; das heißt, sie überleben nicht das Scheitern des Teilnehmers. Darüber hinaus schlägt diese Methode nur den Transaktionsmanager vor, die Kontrolle zu eskalieren, aber die Eskalation selbst ist nicht garantiert. Wenn die Eskalation fehlschlägt, wird der Benutzer nicht benachrichtigt, und die Transaktion wird zurückgesetzt.

Der Parameter promotableSinglePhaseNotification wird verwendet, um dem Transaktionsmanager das Ergebnis des Commits der internen Transaktion des Ressourcenmanagers mitzuteilen. Wenn inkonsistente Daten gemeldet werden, löst der Transaktionsmanager eine Ausnahme aus. Wenn ein InDoubt Ergebnis gemeldet wird, sucht der Transaktionsmanager in einer eigenen internen Liste nach der Ergebnisbenachrichtigung und ignoriert die gemeldete Antwort.

Weitere Informationen zu Listen und Eskalationen einer Transaktion finden Sie unter Transaktionsverwaltungseskalation. Weitere Informationen zu PSPE finden Sie unter Optimierung mit Single Phase Commit und Promotable Single Phase Notification.

Gilt für:

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification, Guid)

Quelle:
Transaction.cs
Quelle:
Transaction.cs
Quelle:
Transaction.cs

Enlists a resource manager that has an internal transaction using a promotable single phase enlistment (PSPE).

public:
 bool EnlistPromotableSinglePhase(System::Transactions::IPromotableSinglePhaseNotification ^ promotableSinglePhaseNotification, Guid promoterType);
public bool EnlistPromotableSinglePhase (System.Transactions.IPromotableSinglePhaseNotification promotableSinglePhaseNotification, Guid promoterType);
member this.EnlistPromotableSinglePhase : System.Transactions.IPromotableSinglePhaseNotification * Guid -> bool
Public Function EnlistPromotableSinglePhase (promotableSinglePhaseNotification As IPromotableSinglePhaseNotification, promoterType As Guid) As Boolean

Parameter

promotableSinglePhaseNotification
IPromotableSinglePhaseNotification

Eine vom Teilnehmer implementierte IPromotableSinglePhaseNotification Schnittstelle.

promoterType
Guid

Der Typ des verteilten Transaktionsprozessors.

Gibt zurück

Eine SinglePhaseEnlistment Schnittstellenimplementierung, die die Einlistung beschreibt.

Hinweise

Wenn der für den parameter angegebene Wert ist, muss die Transaktion von MSDTC höhergestuft werden, und die von der Methode zurückgegebene muss ein MSDTC-Transaktionsverteilungstoken sein.

Wenn der für den parameter angegebene Wert nichtist, wird die Transaktion nicht von MSDTC höhergestuft, sondern durch die Implementierung von des Aufrufers. Wenn dieser Aufruf erfolgreich ist, gibt es eine Reihe von nachfolgenden Vorgängen für die Transaktion, die eine TransactionPromotionExceptionzurückgibt. Diese Vorgänge sind:

  • Transaction.EnlistDurable

  • TransactionInterop.GetDtcTransaction

  • TransactionInterop.GetExportCookie

  • TransactionInterop.GetTransmitterPropagationToken

  • Serialisierung eines Transaction-Objekts

Gilt für: