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, FltGetFileNameInformationUnsafe oder FltGetTunneledName zurückgegeben wurde. Dieser Parameter ist erforderlich und darf nicht NULL sein.
Rückgabewert
FltParseFileNameInformation gibt STATUS_SUCCESS oder einen entsprechenden NTSTATUS-Fehlercode zurück.
Hinweise
FltParseFileNameInformation analysiert das Name-Element einer FLT_FILE_NAME_INFORMATION-Struktur und verwendet die Ergebnisse, um die Werte der Member Volume, Share, Extension, Stream, FinalComponent, ParentDir und NamesParsed dieser Struktur festzulegen. Weitere Informationen finden Sie unter FLT_FILE_NAME_INFORMATION.
Es folgt 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"
Freigabe: "\MyServer\MyShare"
Erweiterung: "txt"
Stream: ":stream1"
FinalComponent: "Test Results.txt:stream1"
ParentDir: "\Dokumente und Einstellungen\MyUser\Meine Dokumente"
Es folgt 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"
Freigabe: NULL
Erweiterung: "txt"
Stream: ":stream1:$DATA"
FinalComponent: "TestRe~1.txt:stream1:$DATA"
ParentDir: "\Docume~1\MyUser\Meine Dokumente"
Es folgt ein Beispiel für einen kurzen Namen für eine Datei:
TestRe~1.txt
FltParseFileNameInformation analysiert diesen kurzen Namen wie folgt:
Volume: NULL
Freigabe: NULL
Erweiterung: "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, sodass sie von allen Minifiltertreibern verwendet werden kann.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows XP SP2 und höheren Versionen des Windows-Betriebssystems. |
| Zielplattform | Universell |
| Header | fltkernel.h (include Fltkernel.h) |
| Bibliothek | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |
Weitere Informationen
FltGetDestinationFileNameInformation