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.
GetHandle
Returns 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.
Platforms: Windows Vista
Header: Declared in transact.h
[InterfaceType(ComInterfaceType.InterfaceIsIUnknown), Guid("79427A2B-F895-40e0-BE79-B57DC82ED231")] public interface IKernelTransaction { int GetHandle(out IntPtr pHandle); }
<InterfaceType(ComInterfaceType.InterfaceIsIUnknown), Guid("79427A2B-F895-40e0-BE79-B57DC82ED231")> Public Interface IKernelTransaction Function GetHandle(<Out> ByRef pHandle As IntPtr) As Integer End Interface