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:


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


Enlistment Access Masks

Kernel Transaction Manager Functions