Функция FltRequestSecurityInfoOnCreateCompletion (fltkernel.h)
Минифильтр вызывает FltRequestSecurityInfoOnCreateComplet ion во время предварительного создания файла, чтобы запросить, чтобы файловая система сохраняла сведения о безопасности файлов для получения во время создания после создания.
Синтаксис
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 (include Fltkernel.h) |