NtCreateResourceManager 函数 （wdm.h）
ZwCreateResourceManager 例程创建 资源管理器对象。
语法
__kernel_entry NTSYSCALLAPI NTSTATUS NtCreateResourceManager(
[out] PHANDLE ResourceManagerHandle,
[in] ACCESS_MASK DesiredAccess,
[in] HANDLE TmHandle,
[in] LPGUID RmGuid,
[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
事务管理器对象 的句柄，该对象由以前所有对象 ZwCreateTransactionManager 或 ZwOpenTransactionManager获取。
[in] RmGuid
指向 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。 否则，此例程可能会返回以下值之一：
| 返回代码 | 描述 |
|---|---|
|
TmHandle 指定的句柄不是事务对象的句柄。 |
|
TmHandle 指定的句柄无效。 |
|
调用方无权访问指定的事务管理器对象。 |
|
TmHandle 指定的句柄已关闭。 |
|
CreateOptions 参数的值无效，或者 说明 参数的字符串太长。 |
|
CreateOptions 参数未指定RESOURCE_MANAGER_VOLATILE，但 TmHandle 指定的事务管理器是可变的。 |
|
ResourceManagerGuid 指定的 GUID 已存在。 |
|
DesiredAccess 参数的值无效。 |
例程可能会 返回其他NTSTATUS 值。
言论
调用 ZwCreateResourceManager 的资源管理器最终必须调用 ZwClose 才能关闭对象句柄。
有关 ZwCreateResourceManager的详细信息，请参阅 创建资源管理器。
对于内核模式驱动程序的调用，NtXxx 和 ZwXxx 版本的 Windows 本机系统服务例程的行为方式可能以不同的方式处理和解释输入参数。 有关 NtXxx 与 ZwXxx 例程之间的关系的详细信息，请参阅 使用 Nt 和 Zw 版本的本机系统服务例程。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | 在 Windows Vista 和更高版本的作系统版本中可用。 |
| 目标平台 | 普遍 |
| 标头 | wdm.h （包括 Wdm.h、Ntddk.h、Ntifs.h） |
| 库 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI 符合性规则 | HwStorPortProhibitedDDI、PowerIrpDDis |
另请参阅
ZwGetNotificationResourceManager