Transaction.GetPromotedToken Transaction.GetPromotedToken Transaction.GetPromotedToken Transaction.GetPromotedToken Method


トランザクションを昇格するときに、Promote メソッドで返される byte[] を取得します。Gets the byte[] returned by the Promote method when the transaction is promoted.

 cli::array <System::Byte> ^ GetPromotedToken();
public byte[] GetPromotedToken ();
member this.GetPromotedToken : unit -> byte[]
Public Function GetPromotedToken () As Byte()



トランザクションを昇格するときに、Promote メソッドで返される 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.

返されるbyte[]の形式は、 Transaction.PromoterTypeプロパティの値によって定義されます。The format of the returned byte[] is defined by the value of the Transaction.PromoterType property. Transaction.PromoterTypeプロパティの値がTransactionInterop.PromoterTypeDtcまたはGuid.Emptyの場合、このメソッドbyte[]によって返されるは MSDTC 送信者の伝達トークンです。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. Transaction.PromoterTypeプロパティのその他の値は、プロパティの型の値を指定しTransaction.EnlistPromotableSinglePhaseたの呼び出し元によって定義される形式を指定します。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. この後者の場合は、昇格されたトークンを解釈するために、 EnlistPromotableSinglePhase呼び出しを行ったコードのドキュメントを参照する必要があります。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.