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:
© 2014 Microsoft