Transaction.EnlistPromotableSinglePhase Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Transactions

Zestaw:: System.Transactions.Local.dll

Zestaw:: System.Transactions.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Enlists a resource manager, który ma transakcję wewnętrzną przy użyciu promotable pojedynczej fazy rejestracji (PSPE).

Przeciążenia

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification, Guid)	Enlists a resource manager, który ma transakcję wewnętrzną przy użyciu promotable pojedynczej fazy rejestracji (PSPE).
EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification)	Enlists a resource manager, który ma transakcję wewnętrzną przy użyciu promotable pojedynczej fazy rejestracji (PSPE).

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification, Guid)

Enlists a resource manager, który ma transakcję wewnętrzną przy użyciu promotable pojedynczej fazy rejestracji (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

Parametry

promotableSinglePhaseNotification: IPromotableSinglePhaseNotification

IPromotableSinglePhaseNotification Interfejs zaimplementowany przez uczestnika.

promoterType: Guid

Typ rozproszonego procesora transakcji.

Zwraca

Boolean

Implementacja SinglePhaseEnlistment interfejsu, która opisuje rejestrację.

Uwagi

Jeśli wartość określona dla parametru promoterType to TransactionInterop.PromoterTypeDtc, transakcja musi być promowana przez MSDTC, a byte[] zwrócona z IPromotableSinglePhaseNotification.Promote metody musi być tokenem propagacji transakcji MSDTC.

Jeśli wartość określona dla parametru promoterType nieTransactionInterop.PromoterTypeDTC jest, transakcja nie będzie promowana przez MSDTC, ale raczej przez implementację obiektu wywołującego IPromotableSinglePhaseNotification. Jeśli to wywołanie powiedzie się, istnieje zestaw kolejnych operacji na transakcji, która zwróci TransactionPromotionExceptionwartość . Te operacje to:

Transaction.EnlistDurable
TransactionInterop.GetDtcTransaction
TransactionInterop.GetExportCookie
TransactionInterop.GetTransmitterPropagationToken
Serializacja obiektu Transaction

Dotyczy

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification)

Enlists a resource manager, który ma transakcję wewnętrzną przy użyciu promotable pojedynczej fazy rejestracji (PSPE).

public:
 bool EnlistPromotableSinglePhase(System::Transactions::IPromotableSinglePhaseNotification ^ promotableSinglePhaseNotification);

public:
 bool EnlistPromotableSinglePhase(System::Transactions::IPromotableSinglePhaseNotification ^ notification);

public bool EnlistPromotableSinglePhase (System.Transactions.IPromotableSinglePhaseNotification promotableSinglePhaseNotification);

public bool EnlistPromotableSinglePhase (System.Transactions.IPromotableSinglePhaseNotification notification);

member this.EnlistPromotableSinglePhase : System.Transactions.IPromotableSinglePhaseNotification -> bool

member this.EnlistPromotableSinglePhase : System.Transactions.IPromotableSinglePhaseNotification -> bool

Public Function EnlistPromotableSinglePhase (promotableSinglePhaseNotification As IPromotableSinglePhaseNotification) As Boolean

Public Function EnlistPromotableSinglePhase (notification As IPromotableSinglePhaseNotification) As Boolean

Parametry

promotableSinglePhaseNotificationnotification: IPromotableSinglePhaseNotification

IPromotableSinglePhaseNotification Interfejs zaimplementowany przez uczestnika.

Zwraca

Boolean

Implementacja SinglePhaseEnlistment interfejsu, która opisuje rejestrację.

Uwagi

Rejestracje w transakcji są niestabilne; oznacza to, że nie przetrwają porażki uczestnika. Ponadto ta metoda sugeruje tylko menedżerowi transakcji eskalację kontroli, ale sama eskalacja nie jest gwarantowana. Jeśli eskalacja nie powiedzie się, użytkownik zostanie powiadomiony i transakcja zostanie wycofana.

Parametr promotableSinglePhaseNotification służy do komunikowania się z menedżerem transakcji wynikiem próby zatwierdzenia transakcji wewnętrznej menedżera zasobów. W przypadku zgłaszania niespójnych danych menedżer transakcji zgłasza wyjątek. InDoubt Jeśli wynik zostanie zgłoszony, menedżer transakcji szuka powiadomienia o wyniku we własnym wewnętrznym rejestracji i ignoruje zgłoszoną odpowiedź.

Aby uzyskać więcej informacji na temat rejestracji i eskalacji transakcji, zobacz Eskalacja zarządzania transakcjami. Aby uzyskać więcej informacji na temat programu PSPE, zobacz Optymalizacja przy użyciu zatwierdzania jednofazowego i promotable jednofazowego powiadomienia.

Uwaga Ta metoda używa LinkDemand metody, aby zapobiec wywoływaniu z niezaufanego kodu. Jednak tylko bezpośredni obiekt wywołujący jest wymagany do posiadania FullTrust zestawu uprawnień.

Dotyczy