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 的任何可选属性。

[in] TmHandle

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

[in, optional] Description

此 RM 的说明。

返回值

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

如果函数失败，则返回值INVALID_HANDLE_VALUE。 若要获取扩展的错误信息，请调用 GetLastError 函数。

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

言论

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

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

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

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

要求

另请参阅

内核事务管理器函数

OpenResourceManager

SECURITY_ATTRIBUTES

SetResourceManagerCompletionPort