Функция FltRetrieveFileInfoOnCreateCompletion (fltkernel.h)

Статья
02/29/2024

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

Указатель на данные обратного вызова FLT_CALLBACK_DATA , представляющие операцию ввода-вывода.

[in] InfoClass

Флаг, указывающий тип возвращаемых сведений. Обратите внимание, что флаги нельзя объединять. Может иметь одно из следующих значений:

Flag	Значение
QoCFileStatInformation (0x00000001)	Файловая система вернет сведения о состоянии файла в QUERY_ON_CREATE_FILE_STAT_INFORMATION структуре.
QoCFileLxInformation (0x00000002)	Файловая система будет возвращать расширенные сведения, подобные Linux, в QUERY_ON_CREATE_FILE_LX_INFORMATION структуре.
QoCFileEaInformation (0x00000004)	Файловая система вернет расширенные атрибуты (EA) в QUERY_ON_CREATE_EA_INFORMATION структуре.

[out] Size

Указатель на ULONG, указывающий размер буфера, возвращаемого этой функцией, в байтах.

Возвращаемое значение

FltRetrieveFileInfoOnCreateCompletion возвращает указатель на буфер с запрошенными сведениями о файле. Структура в буфере определяется значением InfoClass. Если файловая система обрабатывает запрос, но не может найти запрошенные сведения о файле, этот параметр имеет значение NULL.

Минифильтр должен вызывать FltRequestFileInfoOnCreateCompletion во время предварительного создания файла, чтобы указать, какие сведения о файле должна отслеживать файловая система.