通过

FltRequestSecurityInfoOnCreateCompletion 函数 (fltkernel.h)

  • 项目

微筛选器在文件预创建期间调用 FltRequestSecurityInfoOnCreateCompletion ，以请求文件系统存储文件安全信息，以便在创建后进行检索。

语法

NTSTATUS FLTAPI FltRequestSecurityInfoOnCreateCompletion(
  PFLT_FILTER          Filter,
  PFLT_CALLBACK_DATA   Data,
  SECURITY_INFORMATION SecurityInformation
);

参数

Filter

唯一标识微筛选器驱动程序的不透明筛选器指针。

Data

指向表示 I/O 创建操作 的FLT_CALLBACK_DATA 回调数据的指针。

SecurityInformation

SECURITY_INFORMATION 值，指定要设置为以下一项或多项组合的信息。

值 含义
OWNER_SECURITY_INFORMATION 指示要设置对象的所有者标识符。 需要WRITE_OWNER访问权限。
GROUP_SECURITY_INFORMATION 指示要设置对象的主组标识符。 需要WRITE_OWNER访问权限。
DACL_SECURITY_INFORMATION 指示要设置对象的 DACL) (任意访问控制列表。 需要WRITE_DAC访问权限。
SACL_SECURITY_INFORMATION 指示要设置对象的系统 ACL (SACL) 。 需要ACCESS_SYSTEM_SECURITY访问权限。

返回值

FltRequestSecurityInfoOnCreateCompletion 可以返回以下值之一：

返回代码 说明
STATUS_SUCCESS 文件系统已成功存储请求的文件安全信息。
STATUS_INSUFFICIENT_RESOURCES FltRequestSecurityInfoOnCreateCompletion 无法分配足够的内存来存储请求的文件信息。
STATUS_INVALID_PARAMETER_2 提供的回调数据对象不是基于 IRP 的创建操作。

注解

微筛选器可以通过在创建后期间调用 FltRetrieveFileInfoOnCreateCompletionEx 或 FltRetrieveFileInfoOnCreateCompletion 来检索文件信息。 当以这种方式请求和检索文件信息时，微筛选器的性能通常更好，而不是以后查询文件信息。

要求

要求 值
最低受支持的客户端 Windows 11，版本 24H2
标头 fltkernel.h (包括 Fltkernel.h)

另请参阅

FltRetrieveFileInfoOnCreateCompletion

FltRetrieveFileInfoOnCreateCompletionEx