Fonction FltRequestSecurityInfoOnCreateCompletion (fltkernel.h)
Un minifiltre appelle FltRequestSecurityInfoOnCreateCompletion pendant la précréation de fichiers pour demander que le système de fichiers stocke les informations de sécurité des fichiers à récupérer lors de la post-création.
Syntaxe
NTSTATUS FLTAPI FltRequestSecurityInfoOnCreateCompletion(
PFLT_FILTER Filter,
PFLT_CALLBACK_DATA Data,
SECURITY_INFORMATION SecurityInformation
);
Paramètres
Filter
Pointeur de filtre opaque qui identifie de manière unique le pilote minifilter.
Data
Pointeur vers les données de rappel FLT_CALLBACK_DATA représentant l’opération de création d’E/S.
SecurityInformation
SECURITY_INFORMATION valeur spécifiant les informations à définir en combinaison d’une ou de plusieurs des options suivantes.
| Valeur | Signification |
|---|---|
| OWNER_SECURITY_INFORMATION | Indique que l’identificateur de propriétaire de l’objet doit être défini. Nécessite un accès WRITE_OWNER. |
| GROUP_SECURITY_INFORMATION | Indique que l’identificateur de groupe principal de l’objet doit être défini. Nécessite un accès WRITE_OWNER. |
| DACL_SECURITY_INFORMATION | Indique que la liste de contrôle d’accès discrétionnaire (DACL) de l’objet doit être définie. Nécessite un accès WRITE_DAC. |
| SACL_SECURITY_INFORMATION | Indique que la liste de contrôle d’accès système (SACL) de l’objet doit être définie. Nécessite un accès ACCESS_SYSTEM_SECURITY. |
Valeur retournée
FltRequestSecurityInfoOnCreateCompletion peut retourner l’une des valeurs suivantes :
| Code de retour | Description |
|---|---|
| STATUS_SUCCESS | Le système de fichiers a correctement stocké les informations de sécurité des fichiers demandées. |
| STATUS_INSUFFICIENT_RESOURCES | FltRequestSecurityInfoOnCreateCompletion n’a pas pu allouer suffisamment de mémoire pour stocker les informations de fichier demandées. |
| STATUS_INVALID_PARAMETER_2 | L’objet de données de rappel fourni n’était pas une opération de création basée sur IRP. |
Remarques
Le minifilter peut récupérer les informations de fichier en appelant FltRetrieveFileInfoOnCreateCompletionEx ou FltRetrieveFileInfoOnCreateCompletion lors de la post-création. Les performances d’un minifiltre sont généralement meilleures lorsqu’il demande et récupère des informations de fichier de cette manière, plutôt que d’interroger les informations de fichier ultérieurement.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 11, version 24H2 |
| En-tête | fltkernel.h (inclure Fltkernel.h) |