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

Siehe auch

FLT_FILE_NAME_INFORMATION

FltGetDestinationFileNameInformation

FltGetFileNameInformation

FltGetFileNameInformationUnsafe-

FltGetTunneledName

FltParseFileName-