Funzione FltRequestSecurityInfoOnCreateCompletion (fltkernel.h)
Un minifilter chiama FltRequestSecurityInfoOnCreateCompletion durante la pre-creazione del file per richiedere che il file system archivia le informazioni di sicurezza dei file per il recupero durante la creazione post.
Sintassi
NTSTATUS FLTAPI FltRequestSecurityInfoOnCreateCompletion(
PFLT_FILTER Filter,
PFLT_CALLBACK_DATA Data,
SECURITY_INFORMATION SecurityInformation
);
Parametri
Filter
Puntatore filtro opaco che identifica in modo univoco il driver minifilter.
Data
Puntatore ai dati di callback FLT_CALLBACK_DATA che rappresentano l'operazione di creazione di I/O.
SecurityInformation
SECURITY_INFORMATION valore che specifica le informazioni da impostare come combinazione di una o più delle seguenti informazioni.
| Valore | Significato |
|---|---|
| OWNER_SECURITY_INFORMATION | Indica che l'identificatore proprietario dell'oggetto deve essere impostato. Richiede l'accesso WRITE_OWNER. |
| GROUP_SECURITY_INFORMATION | Indica che l'identificatore del gruppo primario dell'oggetto deve essere impostato. Richiede l'accesso WRITE_OWNER. |
| DACL_SECURITY_INFORMATION | Indica l'elenco di controllo di accesso discrezionale dell'oggetto da impostare. Richiede WRITE_DAC accesso. |
| SACL_SECURITY_INFORMATION | Indica che l'ACL di sistema (SACL) dell'oggetto deve essere impostato. Richiede ACCESS_SYSTEM_SECURITY accesso. |
Valore restituito
FltRequestSecurityInfoOnCreateCompletion può restituire uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_SUCCESS | Il file system ha archiviato correttamente le informazioni di sicurezza dei file richieste. |
| STATUS_INSUFFICIENT_RESOURCES | FltRequestSecurityInfoOnCreateCompletion non è stato in grado di allocare memoria sufficiente in cui archiviare le informazioni sul file richiesto. |
| STATUS_INVALID_PARAMETER_2 | L'oggetto dati di callback fornito non era un'operazione di creazione basata su IRP. |
Commenti
Il minifilter può recuperare le informazioni sul file chiamando FltRetrieveFileInfoOnCreateCompletionEx o FltRetrieveFileInfoOnCreateCompletion durante la creazione post. Le prestazioni di un minifilter sono in genere migliori quando richiede e recuperano le informazioni sui file in questo modo, anziché eseguire query sulle informazioni sui file in un secondo momento.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 11, versione 24H2 |
| Intestazione | fltkernel.h (includere Fltkernel.h) |