FltRetrieveFileInfoOnCreateCompletion, fonction (fltkernel.h)
FltRetrieveFileInfoOnCreateCompletion récupère les informations de fichier demandées lors de la création d’un billet de 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 le FLT_CALLBACK_DATA données de rappel 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. Il peut s’agir de l’une des valeurs suivantes :
| Drapeau | Signification |
|---|---|
| QoCFileStatInformation (0x00000001) | Le système de fichiers retourne des informations statistiques de fichier dans une structure QUERY_ON_CREATE_FILE_STAT_INFORMATION. |
| QoCFileLxInformation (0x00000002) | Le système de fichiers retourne des informations de type Linux étendues 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 des 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 de retour
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 de InfoClass. Si le système de fichiers traite la requête mais ne trouve pas les informations demandées sur le fichier, ce paramètre est défini sur NULL.
Remarques
Un minifilter 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.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | fltkernel.h |