CreateResourceManager function (ktmw32.h)
Creates a new resource manager (RM) object, and associates the RM with a transaction manager (TM).
HANDLE CreateResourceManager( [in, optional] LPSECURITY_ATTRIBUTES lpResourceManagerAttributes, [in] LPGUID ResourceManagerId, [in, optional] DWORD CreateOptions, [in] HANDLE TmHandle, [in, optional] LPWSTR Description );
[in, optional] lpResourceManagerAttributes
A pointer to a SECURITY_ATTRIBUTES structure that contains the security attributes for the resource manager. Specify NULL to obtain the default attributes.
A pointer the resource manager GUID. This parameter is required and must not be NULL.
[in, optional] CreateOptions
Any optional attributes for the new RM.
||Indicates that the RM is volatile, and does not perform recovery.|
A handle to the TM that will manage the transactions for this RM.
[in, optional] Description
A description for this RM.
If the function succeeds, the return value is a handle to the RM.
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:
Immediately after calling this function, you must call RecoverResourceManager.
An RM is an endpoint for TM notifications regarding transactions that the RM has enlisted in.
RMs are typically persistent, meaning that after a system failure, they must be reopened to perform certain operations. Volatile, or transient, RMs can be created by calling the CreateResourceManager function and by specifying RESOURCE_MANAGER_VOLATILE. Volatile RMs do not perform recovery operations, but do require notifications about a transaction.
You can create a volatile RM on a durable TM, but you cannot create a durable RM on a volatile TM.
|Minimum supported client||Windows Vista|
|Minimum supported server||Windows Server 2008|