OpenTransactionManager function (ktmw32.h)

Article
07/27/2022

Opens an existing transaction manager.

Syntax

HANDLE OpenTransactionManager(
  [in]           LPWSTR      LogFileName,
  [in]           ACCESS_MASK DesiredAccess,
  [in, optional] ULONG       OpenOptions
);

Parameters

[in] LogFileName

The name of the log stream. This stream must exist within a CLFS log file.

[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.

The LogFileName must be specified using the NT file format. For example: ??<drive>:<path>. Do not use the .BLF extension.

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