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

Статья
12/21/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

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

Флаг	Значение
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 структуре.
QoCFileUsnInformation (0x00000008)	Файловая система вернет сведения ОБ USN в QUERY_ON_CREATE_USN_INFORMATION структуре.
QoCFileSecurityInformation (0x00000010)	Файловая система вернет сведения о безопасности файлов в QUERY_ON_CREATE_SECURITY_INFORMATION структуре.

[out] Size

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

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

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

Замечания

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

Требования

Требование	Ценность
заголовка	fltkernel.h

См. также

FLT_CALLBACK_DATA

FltRequestFileInfoOnCreateCompletion

FltRetrieveFileInfoOnCreateCompletionEx

Поделиться через