Partager via

Fonction FltRequestSecurityInfoOnCreateCompletion (fltkernel.h)

  • Article

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)

Voir aussi

FltRetrieveFileInfoOnCreateCompletion

FltRetrieveFileInfoOnCreateCompletionEx