ITransactionJoin Interface

IID_ITransactionJoin

{0C733A5E-2A1C-11CE-ADE5-00AA0044773D}

ITransactionJoin is exposed only by providers that support distributed transactions. The consumer calls QueryInterface for ITransactionJoin to determine whether the provider supports distributed transactions. For more information about transactions, see Chapter 15: Transactions.

Documentation: ITransactionJoin

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

ITransactionJoin Methods

Description

GetOptionsObject

Returns an object that can be used to specify configuration options for a subsequent call to JoinTransaction.

JoinTransaction

Requests that the session enlist in a coordinated transaction.

QueryInterface

FUNCTION ITransactionJoin_QueryInterface ( _

  BYVAL pthis AS DWORD PTR _

, BYREF riid AS GUID _

, BYREF ppvObj AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[0] USING ITransactionJoin_QueryInterface (pthis, riid, ppvObj) TO HRESULT
  FUNCTION = HRESULT
 

END FUNCTION

AddRef

FUNCTION ITransactionJoin_AddRef ( _

  BYVAL pthis AS DWORD PTR _

  ) AS DWORD
 

  LOCAL DWRESULT AS LONG
  CALL DWORD @@pthis[1] USING ITransactionJoin_AddRef (pthis) TO DWRESULT
  FUNCTION = DWRESULT
 

END FUNCTION

Release

FUNCTION ITransactionJoin_Release ( _

  BYVAL pthis AS DWORD PTR _

  ) AS DWORD
 

  LOCAL DWRESULT AS DWORD
  CALL DWORD @@pthis[2] USING ITransactionJoin_Release (pthis) TO DWRESULT
  FUNCTION = DWRESULT
 

END FUNCTION

GetOptionsObject

FUNCTION ITransactionJoin_GetOptionsObject ( _
  BYVAL pthis AS DWORD PTR _

, BYREF ppOptions AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[3] USING ITransactionJoin_GetOptionsObject (pthis, ppOptions) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

JoinTransaction

FUNCTION ITransactionJoin_JoinTransaction ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL punkTransactionCoord AS DWORD _

, BYVAL isoLevel AS LONG _

, BYVAL isoFlags AS DWORD _

, BYVAL pOtherOptions AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[4] USING ITransactionJoin_JoinTransaction (pthis, punkTransactionCoord, isoLevel, isoFLags, pOtherOptions) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION