CreateResourceManager 函数 (ktmw32.h)

(RM) 对象创建新的资源管理器，并将 RM 与事务管理器关联 (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

指向包含资源管理器安全属性 的SECURITY_ATTRIBUTES 结构的指针。 指定 NULL 以获取默认属性。

[in] ResourceManagerId

资源管理器 GUID 的指针。 此参数是必需的，不能为 NULL。

[in, optional] CreateOptions

新 RM 的任何可选属性。

值	含义
RESOURCE_MANAGER_VOLATILE	指示 RM 是可变的，并且不执行恢复。

[in] TmHandle

TM 的句柄，用于管理此 RM 的事务。

[in, optional] Description

此 RM 的说明。

返回值

如果函数成功，则返回值是 RM 的句柄。

如果函数失败，则返回值为 INVALID_HANDLE_VALUE。 若要获得更多的错误信息，请调用 GetLastError 函数。

以下列表标识了可能的错误代码：

注解

调用此函数后，必须立即调用 RecoverResourceManager。

RM 是有关 RM 已登记的事务的 TM 通知的终结点。

VM 通常是永久性的，这意味着在系统发生故障后，必须重新打开它们才能执行某些操作。 可以通过调用 CreateResourceManager 函数和指定RESOURCE_MANAGER_VOLATILE来创建易失性或暂时性 RM。 易失性 RM 不执行恢复操作，但需要有关事务的通知。

可以在持久 TM 上创建可变 RM，但不能在可变 TM 上创建持久 RM。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
目标平台	Windows
标头	ktmw32.h
Library	Ktmw32.lib
DLL	Ktmw32.dll

另请参阅

内核事务管理器函数

OpenResourceManager

SECURITY_ATTRIBUTES

SetResourceManagerCompletionPort