FltParseFileNameInformation-Funktion (fltkernel.h)
FltParseFileNameInformation analysiert den Inhalt einer FLT_FILE_NAME_INFORMATION Struktur.
Syntax
NTSTATUS FLTAPI FltParseFileNameInformation(
[in, out] PFLT_FILE_NAME_INFORMATION FileNameInformation
);
Parameter
[in, out] FileNameInformation
Zeiger auf eine FLT_FILE_NAME_INFORMATION Struktur, die von einem vorherigen Aufruf von FltGetDestinationFileNameInformation, FltGetFileNameInformation, FltGetFileNameInformationUnsafeoder FltGetTunneledNamezurückgegeben wird. Dieser Parameter ist erforderlich und kann nicht NULL-werden.
Rückgabewert
FltParseFileNameInformation gibt STATUS_SUCCESS oder einen entsprechenden NTSTATUS-Fehlercode zurück.
Bemerkungen
FltParseFileNameInformation analysiert den Name Member einer FLT_FILE_NAME_INFORMATION Struktur und verwendet die Ergebnisse zum Festlegen der Werte des Volume, Share, Extension, Stream, FinalComponent, ParentDirund NamesParsed Member dieser Struktur. Weitere Informationen finden Sie unter FLT_FILE_NAME_INFORMATION.
Nachfolgend sehen Sie ein Beispiel für einen normalisierten Namen für eine Remotedatei:
\Device\LanManRedirector\MyServer\MyShare\Documents and Settings\MyUser\My Documents\Test Results.txt:stream1
FltParseFileNameInformation analysiert diesen normalisierten Namen wie folgt:
Volume: "\Device\LanManRedirector"
Freigeben: "\MyServer\MyShare"
Extension: "txt"
Stream-: ":stream1"
FinalComponent: "Testen Results.txt:stream1"
ParentDir: "\Dokumente und Einstellungen\MyUser\Meine Dokumente"
Im Folgenden sehen Sie ein Beispiel für einen geöffneten Namen für eine lokale Datei:
\Device\HarddiskVolume1\Docume~1\MyUser\My Documents\TestRe~1.txt:stream1:$DATA
FltParseFileNameInformation analysiert diesen geöffneten Namen wie folgt:
Volume: "\Device\HarddiskVolume1"
Freigeben: NULL-
Extension: "txt"
Stream-: ":stream1:$DATA"
FinalComponent: "TestRe~1.txt:stream1:$DATA"
ParentDir: "\Docume~1\MyUser\My Documents"
Nachfolgend sehen Sie ein Beispiel für einen kurzen Namen für eine Datei:
TestRe~1.txt
FltParseFileNameInformation analysiert diesen kurzen Namen wie folgt:
Volume: NULL-
Freigeben: NULL-
Extension: "txt"
Stream-: NULL-
FinalComponent: "TestRe~1.txt"
ParentDir-: NULL-
Der Aufrufer darf den Inhalt der FileNameInformation Struktur nicht ändern, da der Filter-Manager diese Struktur zwischenspeichert, damit alle Minifiltertreiber sie verwenden können.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows XP SP2 und höheren Versionen des Windows-Betriebssystems. |
| Zielplattform- | Universal |
| Header- | fltkernel.h (include Fltkernel.h) |
| Library | FltMgr.lib |
| DLL- | Fltmgr.sys |
| IRQL- | <= APC_LEVEL |
Siehe auch
FltGetDestinationFileNameInformation