OpenEnlistment function (ktmw32.h)

Opens an existing enlistment object, and returns a handle to the enlistment.


HANDLE OpenEnlistment(
  [in] DWORD  dwDesiredAccess,
  [in] HANDLE ResourceManagerHandle,
  [in] LPGUID EnlistmentId


[in] dwDesiredAccess

The access requested for this enlistment. See Enlistment Access Masks for a list of valid values.

[in] ResourceManagerHandle

A handle to the resource manager.

[in] EnlistmentId

The enlistment identifier.

Return value

If the function succeeds, the return value is a handle to the enlistment.

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:


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


Enlistment Access Masks

Kernel Transaction Manager Functions