OpenTransactionManager function (ktmw32.h)

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

See also

CreateTransactionManager

GetCurrentClockTransactionManager

Kernel Transaction Manager Functions

OpenTransactionManagerById

Transaction Manager Access Masks