ZwCreateSection 函数 (wdm.h)
ZwCreateSection 例程创建一个 section 对象。
语法
NTSYSAPI NTSTATUS ZwCreateSection(
[out] PHANDLE SectionHandle,
[in] ACCESS_MASK DesiredAccess,
[in, optional] POBJECT_ATTRIBUTES ObjectAttributes,
[in, optional] PLARGE_INTEGER MaximumSize,
[in] ULONG SectionPageProtection,
[in] ULONG AllocationAttributes,
[in, optional] HANDLE FileHandle
);
参数
[out] SectionHandle
指向 HANDLE 变量的指针,该变量接收节对象的句柄。
[in] DesiredAccess
指定一个 ACCESS_MASK 值,该值确定对 对象的请求访问权限。 除了为所有类型的对象定义的访问权限 (请参阅 ACCESS_MASK) 之外,调用方还可以指定以下任何特定于节对象的访问权限:
DesiredAccess 标志 | 允许调用方执行此操作 |
---|---|
SECTION_EXTEND_SIZE | 动态扩展节的大小。 |
SECTION_MAP_EXECUTE | 执行节的视图。 |
SECTION_MAP_READ | 读取分区的视图。 |
SECTION_MAP_WRITE | 写入节的视图。 |
SECTION_QUERY | 查询 section 对象以获取有关节的信息。 驱动程序应设置此标志。 |
SECTION_ALL_ACCESS | 上述所有标志与STANDARD_RIGHTS_REQUIRED组合在一起。 |
[in, optional] ObjectAttributes
指向 OBJECT_ATTRIBUTES 结构的指针,该结构指定对象名称和其他属性。 使用 InitializeObjectAttributes 初始化此结构。 如果调用方未在系统线程上下文中运行,则必须在调用 InitializeObjectAttributes 时设置 OBJ_KERNEL_HANDLE 属性。
[in, optional] MaximumSize
指定节的最大大小(以字节为单位)。 ZwCreateSection 将此值向上舍入为最接近的PAGE_SIZE倍数。 如果分区由分页文件支持, MaximumSize 将指定节的实际大小。 如果节由普通文件提供支持, 则 MaximumSize 指定文件可以扩展或映射到的最大大小。
[in] SectionPageProtection
指定要在节中的每个页面上放置的保护。 使用以下四个值之一:PAGE_READONLY、PAGE_READWRITE、PAGE_EXECUTE或PAGE_WRITECOPY。 有关这些值的说明,请参阅 CreateFileMapping。
[in] AllocationAttributes
指定SEC_XXX 标志的位掩码,用于确定节的分配属性。 有关这些标志的说明,请参阅 CreateFileMapping。
[in, optional] FileHandle
(可选)指定打开的文件对象的句柄。 如果 FileHandle 的值为 NULL,则分区由分页文件提供支持。 否则,节由指定文件提供支持。
返回值
ZwCreateSection 在成功时返回STATUS_SUCCESS,或在失败时返回相应的 NTSTATUS 错误代码。 可能的错误状态代码包括以下内容:
返回代码 | 说明 |
---|---|
STATUS_FILE_LOCK_CONFLICT | FileHandle 参数指定的文件已锁定。 |
STATUS_INVALID_FILE_FOR_SECTION | FileHandle 指定的文件不支持节。 |
STATUS_INVALID_PAGE_PROTECTION | 为 SectionPageProtection 参数指定的值无效。 |
STATUS_MAPPED_FILE_SIZE_ZERO | FileHandle 指定的文件大小为零,MaximumSize 为零。 |
STATUS_SECTION_TOO_BIG | MaximumSize 的值太大。 当 MaximumSize 大于系统定义的分区最大值时,或者 MaximumSize 大于指定文件且节不可写时,将发生这种情况。 |
注解
不再使用 SectionHandle 指向的句柄后,驱动程序必须调用 ZwClose 将其关闭。
如果调用方未在系统线程上下文中运行,它必须确保它创建的任何句柄都是专用句柄。 否则,运行驱动程序的上下文的进程可以访问句柄。 有关详细信息,请参阅 对象句柄。
有关设置映射分区和内存视图的详细信息,请参阅 分区和视图。
如果在用户模式下调用此函数,则应使用名称“NtCreateSection”而不是“ZwCreateSection”。
对于来自内核模式驱动程序的调用,Windows 本机系统服务例程的 NtXxx 和 ZwXxx 版本在处理和解释输入参数的方式上的行为可能有所不同。 有关例程的 NtXxx 和 ZwXxx 版本之间的关系的详细信息,请参阅 使用本机系统服务例程的 Nt 和 Zw 版本。
要求
要求 | 值 |
---|---|
目标平台 | 通用 |
标头 | wdm.h (包括 Wdm.h、Ntifs.h) |
Library | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |