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

  • Статья

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

Синтаксис

NTSTATUS FLTAPI FltRequestSecurityInfoOnCreateCompletion(
  PFLT_FILTER          Filter,
  PFLT_CALLBACK_DATA   Data,
  SECURITY_INFORMATION SecurityInformation
);

Параметры

Filter

Указатель непрозрачного фильтра, который однозначно идентифицирует драйвер минифильтра.

Data

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

SecurityInformation

SECURITY_INFORMATION значение, указывающее сведения, которые должны быть заданы в виде сочетания одного или нескольких из следующих значений.

Значение Значение
OWNER_SECURITY_INFORMATION Указывает, что необходимо задать идентификатор владельца объекта. Требуется доступ WRITE_OWNER.
GROUP_SECURITY_INFORMATION Указывает, что необходимо задать идентификатор основной группы объекта. Требуется доступ WRITE_OWNER.
DACL_SECURITY_INFORMATION Указывает, что необходимо задать список управления доступом (DACL) объекта. Требуется доступ WRITE_DAC.
SACL_SECURITY_INFORMATION Указывает, что системный ACL (SACL) объекта должен быть задан. Требуется доступ ACCESS_SYSTEM_SECURITY.

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

FltRequestSecurityInfoOnCreateCompletion может возвращать одно из следующих значений:

Код возврата Описание
STATUS_SUCCESS В файловой системе успешно сохранены запрошенные сведения о безопасности файла.
STATUS_INSUFFICIENT_RESOURCES FltRequestSecurityInfoOnCreateCompletion не удалось выделить достаточный объем памяти для хранения запрошенных сведений о файле.
STATUS_INVALID_PARAMETER_2 Предоставленный объект данных обратного вызова не был операцией создания на основе IRP.

Комментарии

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

Требования

Требование Значение
Минимальная версия клиента Windows 11, версия 24H2
Верхняя часть fltkernel.h (включая Fltkernel.h)

См. также раздел

FltRetrieveFileInfoOnCreateCompletion

FltRetrieveFileInfoOnCreateCompletionEx