Fungsi FltParseFileNameInformation (fltkernel.h)

Artikel
02/26/2024

FltParseFileNameInformation mengurai konten struktur FLT_FILE_NAME_INFORMATION .

Sintaks

NTSTATUS FLTAPI FltParseFileNameInformation(
  [in, out] PFLT_FILE_NAME_INFORMATION FileNameInformation
);

Parameter

[in, out] FileNameInformation

Penunjuk ke struktur FLT_FILE_NAME_INFORMATION yang dikembalikan oleh panggilan sebelumnya ke FltGetDestinationFileNameInformation, FltGetFileNameInformation, FltGetFileNameInformationUnsafe, atau FltGetTunneledName. Parameter ini diperlukan dan tidak boleh NULL.

Nilai kembali

FltParseFileNameInformation mengembalikan STATUS_SUCCESS atau kode kesalahan NTSTATUS yang sesuai.

Keterangan

FltParseFileNameInformation mengurai anggota Nama dari struktur FLT_FILE_NAME_INFORMATION dan menggunakan hasilnya untuk mengatur nilai anggota Volume, Berbagi, Ekstensi, Stream, FinalComponent, ParentDir, dan NamesParsed dari struktur ini. Untuk informasi selengkapnya, lihat FLT_FILE_NAME_INFORMATION.

Berikut ini adalah contoh nama yang dinormalisasi untuk file jarak jauh:

\Device\LanManRedirector\MyServer\MyShare\Documents and Settings\MyUser\My Documents\Test Results.txt:stream1

FltParseFileNameInformation mengurai nama yang dinormalisasi ini sebagai berikut:

Volume: "\Device\LanManRedirector"

Bagikan: "\MyServer\MyShare"

Ekstensi: "txt"

Stream: ":stream1"

FinalComponent: "Uji Results.txt:stream1"

ParentDir: "\Documents and Settings\MyUser\My Documents"

Berikut ini adalah contoh nama yang dibuka untuk file lokal:

\Device\HarddiskVolume1\Docume~1\MyUser\My Documents\TestRe~1.txt:stream1:$DATA

FltParseFileNameInformation mengurai nama yang dibuka ini sebagai berikut:

Volume: "\Device\HarddiskVolume1"

Bagikan: NULL

Ekstensi: "txt"

Stream: ":stream1:$DATA"

FinalComponent: "TestRe~1.txt:stream1:$DATA"

ParentDir: "\Docume~1\MyUser\My Documents"

Berikut ini adalah contoh nama pendek untuk file:

TestRe~1.txt

FltParseFileNameInformation mengurai nama pendek ini sebagai berikut:

Volume: NULL

Bagikan: NULL

Ekstensi: "txt"

Stream: NULL

FinalComponent: "TestRe~1.txt"

ParentDir: NULL

Pemanggil tidak boleh mengubah konten struktur FileNameInformation , karena Manajer Filter menyimpan struktur ini sehingga semua driver minifilter dapat menggunakannya.

Catatan Jika pemanggil mencoba mengurai string, bukan struktur FLT_FILE_NAME_INFORMATION, gunakan rutinitas FltParseFileName alih-alih FltParseFileNameInformation.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows XP SP2 dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Universal
Header	fltkernel.h (termasuk Fltkernel.h)
Pustaka	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL