Transaction::EnlistPromotableSinglePhase Method (IPromotableSinglePhaseNotification^, Guid)
Enlists a resource manager that has an internal transaction using a promotable single phase enlistment (PSPE).
Assembly: System.Transactions (in System.Transactions.dll)
public: [PermissionSetAttribute(SecurityAction::LinkDemand, Name = "FullTrust")] bool EnlistPromotableSinglePhase( IPromotableSinglePhaseNotification^ promotableSinglePhaseNotification, Guid promoterType )
Parameters
- promotableSinglePhaseNotification
-
Type:
System.Transactions::IPromotableSinglePhaseNotification^
A IPromotableSinglePhaseNotification interface implemented by the participant.
- promoterType
-
Type:
System::Guid
The type of the distributed transaction processor.
Return Value
Type: System::BooleanA SinglePhaseEnlistment interface implementation that describes the enlistment.
If the value specified for the promoterType parameter is TransactionInterop.PromoterTypeDtc, the transaction must be promoted by MSDTC and the byte[] returned from the IPromotableSinglePhaseNotification.Promote method must be an MSDTC transaction propagation token.
If the value specified for the promoterType parameter is notTransactionInterop.PromoterTypeDTC, the transaction will not be promoted by MSDTC, but rather by the caller’s implementation of IPromotableSinglePhaseNotification. If this call is successful, there is a set of subsequent operations on the transaction that will return a TransactionPromotionException. These operations are:
Transaction.EnlistDurable
TransactionInterop.GetDtcTransaction
TransactionInterop.GetExportCookie
TransctionInterop.GetTransmitterPropagationToken
Serialization of a Transaction object
Available since 4.6.1