Transaction::EnlistPromotableSinglePhase Method (IPromotableSinglePhaseNotification^, Guid)

 

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

Namespace:   System.Transactions
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::Boolean

A 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

.NET Framework
Available since 4.6.1
Return to top
Show: