Windows Dev Center

OpenEnlistment function

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

Syntax


HANDLE WINAPI OpenEnlistment(
  _In_ DWORD  dwDesiredAccess,
  _In_        ResourceManagerHandle,
  _In_ LPGUID EnlistmentId
);

Parameters

dwDesiredAccess [in]

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

ResourceManagerHandle [in]

A handle to the resource manager.

EnlistmentId [in]

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:

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

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Ktmw32.h

Library

Ktmw32.lib

DLL

Ktmw32.dll

See also

CreateEnlistment
Enlistment Access Masks
Kernel Transaction Manager Functions

 

 

Community Additions

ADD
Show:
© 2015 Microsoft