IKernelTransaction

 

Updated: July 19, 2016

Applies To: Windows 10, Windows 7, Windows 8, Windows 8.1, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2, Windows Server Technical Preview, Windows Vista

The IKernelTransaction interface is used to get a transaction handle that can then be passed into transacted Windows APIs. A pointer to this interface is obtained from an ITransaction object that represents an MS Distributed Transaction Coordinator (MSDTC) transaction.

You do not need to implement this interface. It is implemented by the ITransaction object.

Transacted Windows APIs, such as CreateFileTransacted or RegCreateKeyTransacted, require a handle that represents the transaction to be passed as a parameter. Use the IKernelTransaction interface to obtain a handle that represents the transaction to pass to a transacted Windows API.

IKernelTransaction methodDescription
GetHandleReturns a handle that represents the transaction and can be passed as a parameter to transacted Windows APIs.

You can obtain a pointer to this interface by calling IUnknown::QueryInterface on the ITransaction interface on the transaction object with an riid of IID_IKernelTransaction.

For an explanation of the requirement values, see Requirements (Component Services).

Platforms: Windows Server 2016, Windows 10, Windows Server 2012 R2, Windows 8.1, Windows Server 2012, Windows 8, Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista

Header: Declared in transact.h

Community Additions

ADD
Show: