ZwCreateResourceManager 函数 (wdm.h)

ZwCreateResourceManager 例程创建资源管理器对象

语法

NTSYSCALLAPI NTSTATUS ZwCreateResourceManager(
  [out]          PHANDLE            ResourceManagerHandle,
  [in]           ACCESS_MASK        DesiredAccess,
  [in]           HANDLE             TmHandle,
  [in, optional] LPGUID             ResourceManagerGuid,
  [in, optional] POBJECT_ATTRIBUTES ObjectAttributes,
  [in, optional] ULONG              CreateOptions,
  [in, optional] PUNICODE_STRING    Description
);

参数

[out] ResourceManagerHandle

指向调用方分配的变量的指针,如果 对 ZwCreateResourceManager 的调用成功,该变量接收新资源管理器对象的句柄。

[in] DesiredAccess

一个 ACCESS_MASK 值,该值指定调用方对资源管理器对象的请求访问权限。 除了为各种对象定义的访问权限 (查看 ACCESS_MASK) 之外,调用方还可以为资源管理器对象指定以下任一访问权限标志:

ACCESS_MASK标志 允许调用方
RESOURCEMANAGER_ENLIST 在事务中登记 (请参阅 ZwCreateEnlistment) 。
RESOURCEMANAGER_GET_NOTIFICATION 接收有关与此资源管理器关联的事务的通知 (请参阅 ZwGetNotificationResourceManager) 。
RESOURCEMANAGER_REGISTER_PROTOCOL 未使用。
RESOURCEMANAGER_QUERY_INFORMATION 有关资源管理器 (查询信息,请参阅 ZwQueryInformationResourceManager) 。
RESOURCEMANAGER_SET_INFORMATION 未使用。
RESOURCEMANAGER_RECOVER 恢复资源管理器 (请参阅 ZwRecoverResourceManager) 。
RESOURCEMANAGER_COMPLETE_PROPAGATION 未使用。
 

或者,可以指定以下一个或多个泛 型ACCESS_MASK 标志。 (STANDARD_RIGHTS_Xxx 标志是预定义的系统值,用于在系统对象上强制实施安全性。) 还可以将这些泛型标志与上表中的其他标志组合在一起。 下表显示了通用访问权限与特定访问权限的对应方式。

通用访问权限 特定访问权限集
RESOURCEMANAGER_GENERIC_READ STANDARD_RIGHTS_READ、RESOURCEMANAGER_QUERY_INFORMATION和 SYNCHRONIZE
RESOURCEMANAGER_GENERIC_WRITE STANDARD_RIGHTS_WRITE、RESOURCEMANAGER_SET_INFORMATION、RESOURCEMANAGER_RECOVER、RESOURCEMANAGER_ENLIST、RESOURCEMANAGER_GET_NOTIFICATION、RESOURCEMANAGER_REGISTER_PROTOCOL、RESOURCEMANAGER_COMPLETE_PROPAGATION和 SYNCHRONIZE
RESOURCEMANAGER_GENERIC_EXECUTE STANDARD_RIGHTS_EXECUTE、RESOURCEMANAGER_RECOVER、RESOURCEMANAGER_ENLIST、RESOURCEMANAGER_GET_NOTIFICATION、RESOURCEMANAGER_COMPLETE_PROPAGATION和 SYNCHRONIZE
RESOURCEMANAGER_ALL_ACCESS STANDARD_RIGHTS_REQUIRED、RESOURCEMANAGER_GENERIC_READ、RESOURCEMANAGER_GENERIC_WRITE 和 RESOURCEMANAGER_GENERIC_EXECUTE

[in] TmHandle

事务 管理器对象的 句柄,该句柄由前一个全部获取到 ZwCreateTransactionManagerZwOpenTransactionManager

[in, optional] ResourceManagerGuid

指向 KTM 将用于标识资源管理器的 GUID 的指针。 如果此指针为 NULL,KTM 将生成 GUID。

[in, optional] ObjectAttributes

指向 OBJECT_ATTRIBUTES 结构的指针,该结构指定对象名称和其他属性。 使用 InitializeObjectAttributes 例程初始化此结构。 如果调用方未在系统线程上下文中运行,则必须在调用 InitializeObjectAttributes 时设置 OBJ_KERNEL_HANDLE 属性。 此参数是可选的,可以为 NULL

[in, optional] CreateOptions

可选的对象创建标志。 下表包含 Ktmtypes.h 中定义的可用标志。

CreateOptions 标志 含义
RESOURCE_MANAGER_COMMUNICATION 仅限内部使用。
RESOURCE_MANAGER_VOLATILE 调用方将管理易失性资源。 它将是非永久性的,并且不会执行恢复。
 

此参数是可选的,可以为零。

[in, optional] Description

指向调用方提供的 UNICODE_STRING 结构的指针,该结构包含以 NULL 结尾的字符串。 字符串提供资源管理器的说明。 KTM 存储字符串的副本,并在写入日志流的消息中包含该字符串。 最大字符串长度为MAX_RESOURCEMANAGER_DESCRIPTION_LENGTH。 此参数是可选的,可以为 NULL

返回值

如果操作成功,ZwCreateResourceManager 将返回STATUS_SUCCESS。 否则,此例程可能会返回以下值之一:

返回代码 说明
STATUS_OBJECT_TYPE_MISMATCH
TmHandle 指定的句柄不是事务对象的句柄。
STATUS_INVALID_HANDLE
TmHandle 指定的句柄无效。
STATUS_ACCESS_DENIED
调用方对指定的事务管理器对象没有适当的访问权限。
STATUS_TRANSACTION_OBJECT_EXPIRED
TmHandle 指定的句柄已关闭。
STATUS_INVALID_PARAMETER
CreateOptions 参数的值无效或 Description 参数的字符串太长。
STATUS_TM_VOLATILE
CreateOptions 参数不指定 RESOURCE_MANAGER_VOLATILE但 TmHandle 指定的事务管理器是可变的。
STATUS_OBJECT_NAME_COLLISION
ResourceManagerGuid 指定的 GUID 已存在。
STATUS_ACCESS_DENIED
DesiredAccess 参数的值无效。
 

例程可能会返回其他 NTSTATUS 值

注解

调用 ZwCreateResourceManager 的资源管理器最终必须调用 ZwClose 以关闭对象句柄。

有关 ZwCreateResourceManager 的详细信息,请参阅创建资源管理器

对于来自内核模式驱动程序的调用,Windows Native System Services 例程的 NtXxxZwXxx 版本在处理和解释输入参数的方式上的行为可能有所不同。 有关例程的 NtXxxZwXxx 版本之间的关系的详细信息,请参阅 使用本机系统服务例程的 Nt 和 Zw 版本

要求

要求
最低受支持的客户端 在 Windows Vista 和更高版本的操作系统版本中可用。
目标平台 通用
标头 wdm.h(包括 Wdm.h、Ntddk.h、Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 符合性规则 HwStorPortProhibitedDDI (storport) PowerIrpDDis (wdm)

另请参阅

ACCESS_MASK

InitializeObjectAttributes

OBJECT_ATTRIBUTES

UNICODE_STRING

ZwClose

ZwCreateEnlistment

ZwCreateTransactionManager

ZwGetNotificationResourceManager

ZwOpenResourceManager

ZwOpenTransactionManager

ZwQueryInformationResourceManager

ZwRecoverResourceManager