ITransactionLocal Interface

IID_ITransactionLocal

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

ITransactionLocal is an optional interface on sessions. It is used to start, commit, and abort transactions on the session. For more information, see "Simple Transactions" in Chapter 15: Transactions.

Documentation: ITransactionLocal

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

ITransaction Methods

Description

Commit

Commits a transaction.

Abort

Aborts a transaction.

GetTransactionInfo

Returns information about a transaction.

ITransactionLocal Methods

Description

GetOptionsObject

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

StartTransaction

Begins a new transaction.

QueryInterface

FUNCTION ITransactionLocal_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 ITransactionLocal_QueryInterface (pthis, riid, ppvObj) TO HRESULT
  FUNCTION = HRESULT
 

END FUNCTION

AddRef

FUNCTION ITransactionLocal_AddRef ( _

  BYVAL pthis AS DWORD PTR _

  ) AS DWORD
 

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

END FUNCTION

Release

FUNCTION ITransactionLocal_Release ( _

  BYVAL pthis AS DWORD PTR _

  ) AS DWORD
 

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

END FUNCTION

Commit

FUNCTION ITransactionLocal_Commit ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL fRetaining AS LONG _

, BYVAL grfTC AS DWORD _

, BYVAL grfRM AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[3] USING ITransactionLocal_Commit (pthis, fRetaining, grfTC, grfRM) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

Abort

FUNCTION ITransactionLocal_Abort ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL pboidReason AS DWORD _

, BYVAL fRetaining AS LONG _

, BYVAL fAsync AS LONG _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[4] USING ITransactionLocal_Abort (pthis, pboidReason, fRetaining, fAsync) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetTransactionInfo

FUNCTION ITransactionLocal_GetTransactionInfo ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL pInfo AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[5] USING ITransactionLocal_GetTransactionInfo (pthis, pInfo) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetOptionsObject

FUNCTION ITransactionLocal_GetOptionsObject ( _
  BYVAL pthis AS DWORD PTR _

, BYREF ppOptions AS DWORD _

  ) AS LONG

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

END FUNCTION

StartTransaction

FUNCTION ITransactionLocal_StartTransaction ( _
  BYVAL pthis AS DWORD PTR _

, BYVAL isoLevel AS LONG _

, BYVAL isoFlags AS DWORD _

, BYVAL pOtherOptions AS DWORD _

, BYREF pulTransactionLevel AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[7] USING ITransactionLocal_StartTransaction (pthis, isoLevel, isoFlags, pOtherOptions, pulTransactionLevel) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION