FltRetrieveFileInfoOnCreateCompletion 函数 (fltkernel.h)
FltRetrieveFileInfoOnCreateCompletion 在文件创建期间检索请求的文件信息。 使用 FltRetrieveFileInfoOnCreateCompletionEx 获取 NTSTATUS 代码以及请求的信息。
语法
PVOID FLTAPI FltRetrieveFileInfoOnCreateCompletion(
[in] PFLT_FILTER Filter,
[in] PFLT_CALLBACK_DATA Data,
[in] ULONG InfoClass,
[out] PULONG Size
);
参数
[in] Filter
唯一标识微筛选器驱动程序的不透明筛选器指针。
[in] Data
指向表示 I/O 操作 的FLT_CALLBACK_DATA 回调数据的指针。
[in] InfoClass
指示要返回的信息类型的标志。 请注意，不能合并标志。 可以是以下其中一个值：
| 标志 | 含义 |
|---|---|
| QoCFileStatInformation (0x00000001) | 文件系统将返回 QUERY_ON_CREATE_FILE_STAT_INFORMATION 结构中的文件统计信息。 |
| QoCFileLxInformation (0x00000002) | 文件系统将在 QUERY_ON_CREATE_FILE_LX_INFORMATION 结构中返回类似 Linux 的扩展信息。 |
| QoCFileEaInformation (0x00000004) | 文件系统将在 QUERY_ON_CREATE_EA_INFORMATION结构中 (EA) 返回扩展属性。 |
| QoCFileUsnInformation (0x00000008) | 文件系统将以 QUERY_ON_CREATE_USN_INFORMATION 结构返回 USN 信息。 |
| QoCFileSecurityInformation (0x00000010) | 文件系统将以 QUERY_ON_CREATE_SECURITY_INFORMATION 结构返回文件安全信息。 |
[out] Size
指向 ULONG 的指针，该 ULONG 指定此函数返回的缓冲区的大小（以字节为单位）。
返回值
FltRetrieveFileInfoOnCreateCompletion 返回指向包含所请求文件信息的缓冲区的指针。 缓冲区中的结构由 InfoClass 的值决定。 如果文件系统处理请求但找不到请求的文件信息，则此参数设置为 NULL。
注解
微筛选器必须在文件预创建期间调用 FltRequestFileInfoOnCreateCompletion ，以指定文件系统应跟踪的文件信息。
要求
| 要求 | 值 |
|---|---|
| Header | fltkernel.h |