OpenTransactionManager function

Opens an existing transaction manager.

Syntax


HANDLE WINAPI OpenTransactionManager(
  _In_     LPWSTR      LogFileName,
  _In_     ACCESS_MASK DesiredAccess,
  _In_opt_ ULONG       OpenOptions
);

Parameters

LogFileName [in]

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

DesiredAccess [in]

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

OpenOptions [in, optional]

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:

ERROR_ACCESS_DENIED
ERROR_INSUFFICIENT_RESOURCES
ERROR_INVALID_PARAMETER
ERROR_OBJECT_NAME_INVALID
ERROR_OBJECT_NAME_NOT_FOUND
ERROR_OBJECT_PATH_SYNTAX_BAD
ERROR_OBJECT_TYPE_MISMATCH
ERROR_PRIVILEGE_NOT_HELD

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

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Ktmw32.h

Library

Ktmw32.lib

DLL

Ktmw32.dll

See also

CreateTransactionManager
GetCurrentClockTransactionManager
Kernel Transaction Manager Functions
OpenTransactionManagerById
Transaction Manager Access Masks

 

 

Community Additions

ADD
Show: