Fonction FltRetrieveFileInfoOnCreateCompletion (fltkernel.h)

Article
05/23/2024

FltRetrieveFileInfoOnCreateCompletion récupère les informations de fichier demandées lors de la création du post-fichier. Utilisez FltRetrieveFileInfoOnCreateCompletionEx pour obtenir un code NTSTATUS avec les informations demandées.

Syntaxe

PVOID FLTAPI FltRetrieveFileInfoOnCreateCompletion(
  [in]  PFLT_FILTER        Filter,
  [in]  PFLT_CALLBACK_DATA Data,
  [in]  ULONG              InfoClass,
  [out] PULONG             Size
);

Paramètres

[in] Filter

Pointeur de filtre opaque qui identifie de manière unique le pilote minifilter.

[in] Data

Pointeur vers les données de rappel FLT_CALLBACK_DATA représentant l’opération d’E/S.

[in] InfoClass

Indicateur qui indique le type d’informations à retourner. Notez que les indicateurs ne peuvent pas être combinés. Peut avoir l’une des valeurs suivantes :

Indicateur	Signification
QoCFileStatInformation (0x00000001)	Le système de fichiers retourne des informations statistiques sur les fichiers dans une structure QUERY_ON_CREATE_FILE_STAT_INFORMATION .
QoCFileLxInformation (0x00000002)	Le système de fichiers retourne des informations étendues de type Linux dans une structure QUERY_ON_CREATE_FILE_LX_INFORMATION .
QoCFileEaInformation (0x00000004)	Le système de fichiers retourne des attributs étendus (EA) dans une structure QUERY_ON_CREATE_EA_INFORMATION .
QoCFileUsnInformation (0x00000008)	Le système de fichiers retourne les informations USN dans une structure QUERY_ON_CREATE_USN_INFORMATION .
QoCFileSecurityInformation (0x00000010)	Le système de fichiers retourne les informations de sécurité des fichiers dans une structure QUERY_ON_CREATE_SECURITY_INFORMATION .

[out] Size

Pointeur vers un ULONG qui spécifie la taille, en octets, de la mémoire tampon retournée par cette fonction.

Valeur retournée

FltRetrieveFileInfoOnCreateCompletion retourne un pointeur vers une mémoire tampon avec les informations de fichier demandées. La structure dans la mémoire tampon est déterminée par la valeur d’InfoClass. Si le système de fichiers traite la demande mais ne trouve pas les informations de fichier demandées, ce paramètre est défini sur NULL.

Remarques

Un minifiltre doit appeler FltRequestFileInfoOnCreateCompletion pendant la précréation du fichier pour spécifier les informations de fichier que le système de fichiers doit suivre.