Fonction FltParseFileNameInformation (fltkernel.h)
FltParseFileNameInformation analyse le contenu d’une structure FLT_FILE_NAME_INFORMATION .
Syntaxe
NTSTATUS FLTAPI FltParseFileNameInformation(
[in, out] PFLT_FILE_NAME_INFORMATION FileNameInformation
);
Paramètres
[in, out] FileNameInformation
Pointeur vers une structure FLT_FILE_NAME_INFORMATION retournée par un appel précédent à FltGetDestinationFileNameInformation, FltGetFileNameInformation, FltGetFileNameInformationUnsafe ou FltGetTunneledName. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.
Valeur retournée
FltParseFileNameInformation retourne STATUS_SUCCESS ou un code d’erreur NTSTATUS approprié.
Remarques
FltParseFileNameInformation analyse le membre Name d’une structure FLT_FILE_NAME_INFORMATION et utilise les résultats pour définir les valeurs des membres Volume, Share, Extension, Stream, FinalComponent, ParentDir et NamesParsed de cette structure. Pour plus d’informations, consultez FLT_FILE_NAME_INFORMATION.
Voici un exemple de nom normalisé pour un fichier distant :
\Device\LanManRedirector\MyServer\MyShare\Documents and Settings\MyUser\My Documents\Test Results.txt:stream1
FltParseFileNameInformation analyse ce nom normalisé comme suit :
Volume : « \Device\LanManRedirector »
Partager : « \MyServer\MyShare »
Extension : « txt »
Stream : « :stream1 »
FinalComponent : « Test Results.txt :stream1 »
ParentDir : « \Documents and Settings\MyUser\My Documents »
Voici un exemple de nom ouvert pour un fichier local :
\Device\HarddiskVolume1\Docume~1\MyUser\My Documents\TestRe~1.txt:stream1:$DATA
FltParseFileNameInformation analyse ce nom ouvert comme suit :
Volume : « \Device\HarddiskVolume1 »
Partager : NULL
Extension : « txt »
Stream : « :stream1 :$DATA »
FinalComponent : « TestRe~1.txt :stream1 :$DATA »
ParentDir : « \Docume~1\MyUser\My Documents »
Voici un exemple de nom court pour un fichier :
TestRe~1.txt
FltParseFileNameInformation analyse ce nom court comme suit :
Volume : NULL
Partager : NULL
Extension : « txt »
Stream : NULL
FinalComponent : « TestRe~1.txt »
ParentDir : NULL
L’appelant ne doit pas modifier le contenu de la structure FileNameInformation , car le Gestionnaire de filtre met en cache cette structure afin que tous les pilotes de minifiltre puissent l’utiliser.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows XP SP2 et versions ultérieures du système d’exploitation Windows. |
| Plateforme cible | Universal |
| En-tête | fltkernel.h (inclure Fltkernel.h) |
| Bibliothèque | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |
Voir aussi
FltGetDestinationFileNameInformation