FltParseFileNameInformation, fonction (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, FltGetFileNameInformationUnsafeou FltGetTunneledName. Ce paramètre est obligatoire et ne peut pas être NULL.
Valeur de retour
FltParseFileNameInformation retourne STATUS_SUCCESS ou un code d’erreur NTSTATUS approprié.
Remarques
FltParseFileNameInformation analyse le membre Name d’une structure de FLT_FILE_NAME_INFORMATION et utilise les résultats pour définir les valeurs du volume, Partager, extension, Stream, FinalComponent, ParentDiret NamesParsed membres 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 et paramètres\MyUser\Mes 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\Mes documents »
Voici un exemple de nom court pour un fichier :
TestRe~1.txt
FltParseFileNameInformation analyse ce nom court comme suit :
de 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 minifilter puissent l’utiliser.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows XP SP2 et versions ultérieures du système d’exploitation Windows. |
| plateforme cible | Universel |
| d’en-tête | fltkernel.h (include Fltkernel.h) |
| bibliothèque | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |
Voir aussi
FltGetDestinationFileNameInformation