FltParseFileNameInformation-Funktion (fltkernel.h)

Artikel
03/01/2024

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.

Hinweis Wenn der Aufrufer versucht, eine Zeichenfolge und keine FLT_FILE_NAME_INFORMATION-Struktur zu analysieren, verwenden Sie die FltParseFileName-Routine anstelle von FltParseFileNameInformation.

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