Función FltRequestSecurityInfoOnCreateCompletion (fltkernel.h)
Un minifiltro llama a FltRequestSecurityInfoOnCreateCompletion durante la creación previa del archivo para solicitar que el sistema de archivos almacene información de seguridad de archivos para su recuperación durante la creación posterior.
Sintaxis
NTSTATUS FLTAPI FltRequestSecurityInfoOnCreateCompletion(
PFLT_FILTER Filter,
PFLT_CALLBACK_DATA Data,
SECURITY_INFORMATION SecurityInformation
);
Parámetros
Filter
Puntero de filtro opaco que identifica de forma única el controlador de minifiltro.
Data
Puntero al FLT_CALLBACK_DATA datos de devolución de llamada que representan la operación de creación de E/S.
SecurityInformation
SECURITY_INFORMATION valor que especifica la información que se va a establecer como una combinación de uno o varios de los siguientes.
| Valor | Significado |
|---|---|
| OWNER_SECURITY_INFORMATION | Indica que se va a establecer el identificador de propietario del objeto. Requiere acceso WRITE_OWNER. |
| GROUP_SECURITY_INFORMATION | Indica que se va a establecer el identificador de grupo principal del objeto. Requiere acceso WRITE_OWNER. |
| DACL_SECURITY_INFORMATION | Indica que se va a establecer la lista de control de acceso discrecional (DACL) del objeto. Requiere acceso WRITE_DAC. |
| SACL_SECURITY_INFORMATION | Indica que se va a establecer la ACL del sistema (SACL) del objeto. Requiere acceso ACCESS_SYSTEM_SECURITY. |
Valor devuelto
FltRequestSecurityInfoOnCreateCompletion puede devolver uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
| STATUS_SUCCESS | El sistema de archivos almacenó correctamente la información de seguridad de archivos solicitada. |
| STATUS_INSUFFICIENT_RESOURCES | FltRequestSecurityInfoOnCreateCompletion no pudo asignar suficiente memoria en la que almacenar la información del archivo solicitada. |
| STATUS_INVALID_PARAMETER_2 | El objeto de datos de devolución de llamada proporcionado no era una operación de creación basada en IRP. |
Comentarios
El minifiltro puede recuperar la información del archivo llamando a FltRetrieveFileInfoOnCreateCompletionEx o FltRetrieveFileInfoOnCreateCompletion durante la creación posterior. Normalmente, el rendimiento de un minifiltro es mejor cuando solicita y recupera información de archivo de esta manera, en lugar de consultar información de archivo más adelante.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 11, versión 24H2 |
| Encabezado | fltkernel.h (incluya Fltkernel.h) |