Функция 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

Указатель на данные обратного вызова 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.

Замечания

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

Требования

Требование Ценность
Минимальный поддерживаемый клиент Windows 10, версия 1809
Заголовок fltkernel.h

См. также

FLT_CALLBACK_DATA

FltRequestFileInfoOnCreateCompletion

FltRetrieveFileInfoOnCreateCompletionEx