Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

OpenTransactionManagerById function

Opens an existing transaction manager.

Syntax


HANDLE WINAPI OpenTransactionManagerById(
  _In_     LPGUID      TransactionManagerId,
  _In_     ACCESS_MASK DesiredAccess,
  _In_opt_ ULONG       OpenOptions
);

Parameters

TransactionManagerId [in]

The identifier of the transaction to open.

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.

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
OpenTransactionManager
Transaction Manager Access Masks

 

 

Community Additions

ADD
Show:
© 2015 Microsoft