微型筛选器在文件预创建期间调用 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 的创建作。 |
言论
minifilter 可以通过在创建后期间调用 FltRetrieveFileInfoOnCreateCompletionEx 或 FltRetrieveFileInfoOnCreateCompletion 来检索文件信息。 以这种方式请求和检索文件信息时，微筛选器的性能通常更好，而不是稍后查询文件信息。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows 11 版本 24H2 |
| 标头 | fltkernel.h （包括 Fltkernel.h） |