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

另请参阅

FLT_CALLBACK_DATA

FltRequestFileInfoOnCreateCompletion

FltRetrieveFileInfoOnCreateCompletionEx