Transaction::GetPromotedToken Method ()

 

Gets the byte[] returned by the Promote method when the transaction is promoted.

Namespace:   System.Transactions
Assembly:  System.Transactions (in System.Transactions.dll)

public:
[PermissionSetAttribute(SecurityAction::LinkDemand, Name = "FullTrust")]
array<unsigned char>^ GetPromotedToken()

Return Value

Type: array<System::Byte>^

The byte[] returned by the Promote method when the transaction is promoted.

This method has the side effect of causing promotion of the transaction if it is not already promoted.

The format of the returned byte[] is defined by the value of the Transation.PromoterType property. If the value of the Transaction.PromoterType property is TransactionInterop.PromoterTypeDtc or Guid.Empty, then the byte[] returned by this method is an MSDTC transmitter propagation token. Any other value for the Transaction.PromoterType property specifies a format that is defined by the caller of Transaction.EnlistPromotableSinglePhase that specified the property type value. In order to interpret the promoted token in this latter case, you will need to consult the documentation for the code that made the EnlistPromotableSinglePhase call.

.NET Framework
Available since 4.6.1
Return to top
Show: