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 参数的值无效或 Description 参数的字符串太长。 |
|
CreateOptions 参数不指定 RESOURCE_MANAGER_VOLATILE但 TmHandle 指定的事务管理器是可变的。 |
|
ResourceManagerGuid 指定的 GUID 已存在。 |
|
DesiredAccess 参数的值无效。 |
例程可能会返回其他 NTSTATUS 值。
注解
调用 ZwCreateResourceManager 的资源管理器最终必须调用 ZwClose 以关闭对象句柄。
有关 ZwCreateResourceManager 的详细信息，请参阅创建资源管理器。
对于来自内核模式驱动程序的调用，Windows 本机系统服务例程的 NtXxx 和 ZwXxx 版本在处理和解释输入参数的方式上的行为可能有所不同。 有关例程的 NtXxx 和 ZwXxx 版本之间的关系的详细信息，请参阅 使用本机系统服务例程的 Nt 和 Zw 版本。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 Windows Vista 和更高版本的操作系统中可用。 |
| 目标平台 | 通用 |
| 标头 | wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h） |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI 符合性规则 | HwStorPortProhibitedDDI，PowerIrpDDis |
另请参阅
ZwGetNotificationResourceManager