OpenTransactionManagerById function (ktmw32.h)

Opens an existing transaction manager.

Syntax

HANDLE OpenTransactionManagerById(
  [in]           LPGUID      TransactionManagerId,
  [in]           ACCESS_MASK DesiredAccess,
  [in, optional] ULONG       OpenOptions
);

Parameters

[in] TransactionManagerId

The identifier of the transaction to open.

[in] DesiredAccess

The access requested. See Transaction Manager Access Masks for a list of valid values.

[in, optional] OpenOptions

Reserved; specify zero.

Return value

If the function succeeds, the return value is a handle to the transaction manager.

If the function fails, the return value is INVALID_HANDLE_VALUE. To get extended error information, call the GetLastError function.

The following list identifies the possible error codes:

Remarks

Immediately after calling this function, you must call RecoverTransactionManager.

Requirements

Requirement Value
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header ktmw32.h
Library Ktmw32.lib
DLL Ktmw32.dll

See also

CreateTransactionManager

GetCurrentClockTransactionManager

Kernel Transaction Manager Functions

OpenTransactionManager

Transaction Manager Access Masks