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) |