OpenTransactionManagerById function (ktmw32.h)

Article
02/22/2024

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