ZwOpenSection 函数 (wdm.h)

项目
02/27/2024

ZwOpenSection 例程打开现有节对象的句柄。

语法

NTSYSAPI NTSTATUS ZwOpenSection(
  [out] PHANDLE            SectionHandle,
  [in]  ACCESS_MASK        DesiredAccess,
  [in]  POBJECT_ATTRIBUTES ObjectAttributes
);

参数

[out] SectionHandle

指向 HANDLE 变量的指针，该变量接收 section 对象的句柄。

[in] DesiredAccess

指定一个 ACCESS_MASK 值，该值确定对对象的请求访问权限。有关详细信息，请参阅 ZwCreateSection 的 DesiredAccess 参数。

[in] ObjectAttributes

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

返回值

ZwOpenSection 在成功时返回STATUS_SUCCESS，或在失败时返回相应的错误代码。可能的返回值包括：

注解

如果该节不存在，或者系统未授予请求的访问权限，则操作将失败。

不再使用 SectionHandle 指向的句柄后，驱动程序必须调用 ZwClose 以将其关闭。

如果调用方未在系统线程上下文中运行，则必须确保它创建的任何句柄都是专用句柄。否则，运行驱动程序的上下文中的进程可以访问句柄。有关详细信息，请参阅对象句柄。

如果在用户模式下调用此函数，则应使用名称“NtOpenSection”而不是“ZwOpenSection”。

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

要求

要求	值
最低受支持的客户端	从 Windows 2000 开始可用。
目标平台	通用
标头	wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h）
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI 符合性规则	HwStorPortProhibitedDDI (storport) ， PowerIrpDDis (wdm)