Compartilhar via

3.23.4.4 ITransactionStream::GetTxViaTransmitter (Opnum 6)

  • Artigo

This method returns the Propagation_Token ([MS-DTCO] section 2.2.5.4) of the currently active transaction, or returns an error if the specified TSN is not the same as the CurrentTSN value.

 HRESULT GetTxViaTransmitter(
   [in] unsigned long ulRequestSeq,
   [out] unsigned long* pulcbTransmitterBuffer,
   [out, size_is(,*pulcbTransmitterBuffer)] 
     BYTE** prgbTransmitterBuffer
 );

ulRequestSeq: The caller's TSN of the currently active transaction.

pulcbTransmitterBuffer: The unsigned size, in bytes, of prgbTransmitterBuffer.

prgbTransmitterBuffer: A Propagation_Token of the currently active transaction.

Return Values: The method MUST return a positive value or zero to indicate successful completion, or a negative value to indicate failure. The client MUST treat any negative return value as a fatal error.

When processing this ORPC call, if ulRequestSeq is the same as the CurrentTSN, the ITransactionStream Server (section 3.23) MUST:

  • Set pulcbExportCookie to the size of prgbExportCookie.

  • Copy Propagation_Token of the currently active transaction to the prgbExportCookie out parameter.

Otherwise, the ITransactionStream Server MUST return CONTEXT_E_ABORTED.