NtCreateSectionEx 函数 (ntifs.h)

项目
02/26/2024

NtCreateSectionEx 创建一个节对象** ，并打开具有指定所需访问权限的对象的句柄。它是 NtCreateSection 的扩展版本，它通过指定以指示这实际上是 AWE) 节 (地址窗口扩展来创建节对象。

语法

__kernel_entry NTSYSCALLAPI NTSTATUS NtCreateSectionEx(
  [out]          PHANDLE                 SectionHandle,
  [out]          ACCESS_MASK             DesiredAccess,
  [in, optional] POBJECT_ATTRIBUTES      ObjectAttributes,
  [in, optional] PLARGE_INTEGER          MaximumSize,
  [in]           ULONG                   SectionPageProtection,
  [in]           ULONG                   AllocationAttributes,
  [in, optional] HANDLE                  FileHandle,
  [in/out]       PMEM_EXTENDED_PARAMETER ExtendedParameters,
                 ULONG                   ExtendedParameterCount
);

参数

[out] SectionHandle

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

[out] DesiredAccess

指定一个 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

指定节的最大大小（以字节为单位）。 NtCreateSection 将此值向上舍入为最接近的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，则分区由分页文件提供支持。否则，节由指定文件提供支持。

[in/out] ExtendedParameters

指向 MEM_EXTENDED_PARAMETER 结构的数组的指针，包含用于创建节的扩展参数。

ExtendedParameterCount

ExtendedParameters 指向的数组的大小。

返回值

NtCreateSectionEx 在成功时返回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 大于指定文件且节不可写时，将发生这种情况。