FLT_FILE_NAME_OPTIONS

Article
03/14/2023

Le type FLT_FILE_NAME_OPTIONS est une valeur ULONG qui spécifie le format de nom, la méthode de requête et les indicateurs d’une requête d’informations de nom de fichier.

typedef ULONG FLT_FILE_NAME_OPTIONS;
#define FLT_VALID_FILE_NAME_FORMATS                       0x000000ff
    #define FLT_FILE_NAME_NORMALIZED                      0x00000001
    #define FLT_FILE_NAME_OPENED                          0x00000002
    #define FLT_FILE_NAME_SHORT                           0x00000003
#define FLT_VALID_FILE_NAME_QUERY_METHODS                 0x0000ff00
    #define FLT_FILE_NAME_QUERY_DEFAULT                   0x00000100
    #define FLT_FILE_NAME_QUERY_CACHE_ONLY                0x00000200
    #define FLT_FILE_NAME_QUERY_FILESYSTEM_ONLY           0x00000300
    #define FLT_FILE_NAME_QUERY_ALWAYS_ALLOW_CACHE_LOOKUP 0x00000400
#define FLT_VALID_FILE_NAME_FLAGS                         0xff000000
    #define FLT_FILE_NAME_REQUEST_FROM_CURRENT_PROVIDER   0x01000000
    #define FLT_FILE_NAME_DO_NOT_CACHE                    0x02000000
    #define FLT_FILE_NAME_ALLOW_QUERY_ON_REPARSE          0x04000000

Les bits 0 à 7 indiquent le format de fichier, qui peut être interrogé à l’aide de la macro FltGetFileNameFormat . Pour obtenir une explication de ces formats, consultez FLT_FILE_NAME_INFORMATION. Les valeurs suivantes sont actuellement définies.

Valeur	Signification
FLT_FILE_NAME_NORMALIZED	Nom normalisé du fichier.
FLT_FILE_NAME_OPENED	Nom utilisé lors de l’ouverture du handle dans ce fichier. Ce nom n’est pas normalisé.
FLT_FILE_NAME_SHORT	Nom court (8.3) du fichier. Le nom court d’un fichier n’inclut pas le nom du volume, le chemin d’accès au répertoire ou le nom du flux. Ce nom n’est pas normalisé.

Les bits 8 à 15 spécifient la méthode de requête de nom de fichier à utiliser par le Gestionnaire de filtres, qui peut être interrogée à l’aide de la macro FltGetFileNameQueryMethod . Pour une explication de ces valeurs, consultez FltGetFileNameInformation. Les valeurs suivantes sont actuellement définies.

Valeur	Signification
FLT_FILE_NAME_QUERY_DEFAULT	S’il n’est pas actuellement sûr d’interroger le système de fichiers pour obtenir le nom de fichier, ne faites rien. Sinon, interrogez le cache de noms du Gestionnaire de filtres pour obtenir les informations de nom de fichier. Si le nom est introuvable dans le cache, interrogez le système de fichiers et mettez en cache le résultat.
FLT_FILE_NAME_QUERY_CACHE_ONLY	Interrogez le cache de noms du Gestionnaire de filtres pour obtenir les informations de nom de fichier. N’interrogez pas le système de fichiers.
FLT_FILE_NAME_QUERY_FILESYSTEM_ONLY	Interrogez le système de fichiers pour obtenir les informations de nom de fichier. N’interrogez pas le cache de noms du Gestionnaire de filtres et ne mettez pas en cache le résultat de la requête du système de fichiers.
FLT_FILE_NAME_QUERY_ALWAYS_ALLOW_CACHE_LOOKUP	Interrogez le cache de noms du Gestionnaire de filtres pour obtenir les informations de nom de fichier. Si le nom est introuvable dans le cache et qu’il est actuellement sûr de le faire, interrogez le système de fichiers pour obtenir les informations de nom de fichier et mettre en cache le résultat.

Les bits 16 à 23 sont actuellement inutilisés.

Les bits 24 à 31 sont utilisés par les minifiltres du fournisseur de noms pour spécifier les indicateurs de nom de fichier. Les valeurs suivantes sont actuellement définies.

Valeur	Signification
FLT_FILE_NAME_REQUEST_FROM_CURRENT_PROVIDER	Un minifiltre de fournisseur de noms peut utiliser cet indicateur pour indiquer qu’une demande de requête de nom doit être redirigée vers elle-même au lieu d’être satisfaite par les filtres du fournisseur de noms plus bas dans la pile.
FLT_FILE_NAME_DO_NOT_CACHE	Cet indicateur indique que le nom récupéré à partir de cette requête ne doit pas être mis en cache. Les minifiltres du fournisseur de noms utilisent cet indicateur quand ils exécutent des requêtes intermédiaires pour générer un nom.
FLT_FILE_NAME_ALLOW_QUERY_ON_REPARSE	Un minifiltre de fournisseur de noms peut utiliser cet indicateur pour spécifier qu’il est sûr d’interroger le nom dans le chemin d’accès post-création, même si STATUS_REPARSE a été retourné. Il incombe à l’appelant de s’assurer que le champ FileObject-FileName> n’a pas été modifié. N’utilisez pas cet indicateur avec des points de montage ou des points d’analyse de liens symboliques.