Transaction.GetPromotedToken Method

Definition

Namespace:

System.Transactions

Assembly:

System.Transactions.Local.dll

Source:

Transaction.cs

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

public:
 cli::array <System::Byte> ^ GetPromotedToken();

public byte[] GetPromotedToken ();

member this.GetPromotedToken : unit -> byte[]

Public Function GetPromotedToken () As Byte()

Returns

Byte[]

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

Remarks

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 Transaction.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.