FltRequestSecurityInfoOnCreateCompletion, fonction (fltkernel.h)
Un minifilter appelle FltRequestSecurityInfoOnCreateCompletion pendant la précréation du fichier pour demander que le système de fichiers stocke les informations de sécurité des fichiers pour la récupération pendant la création post-création.
NTSTATUS FLTAPI FltRequestSecurityInfoOnCreateCompletion(
PFLT_FILTER Filter,
PFLT_CALLBACK_DATA Data,
SECURITY_INFORMATION SecurityInformation
);
Filter
Pointeur de filtre opaque qui identifie de manière unique le pilote minifilter.
Data
Pointeur vers le FLT_CALLBACK_DATA données de rappel représentant l’opération de création d’E/S.
SecurityInformation
SECURITY_INFORMATION valeur spécifiant les informations à définir en tant que combinaison d’une ou plusieurs des valeurs 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. |
FltRequestSecurityInfoOnCreateCompletion pouvez retourner l’une des valeurs suivantes :
| Retourner le code | 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. |
Le minifilter peut récupérer les informations de fichier en appelant FltRetrieveFileInfoOnCreateCompletionEx ou FltRetrieveFileInfoOnCreateCompletion pendant la création de publication. Les performances d’un minifilter sont généralement meilleures quand elles demandent et récupèrent des informations de fichier de cette manière, plutôt que d’interroger les informations de fichier ultérieurement.
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 11, version 24H2 |
| d’en-tête | fltkernel.h (include Fltkernel.h) |