Fungsi FltParseFileName (fltkernel.h)

  • Artikel

FltParseFileName mengurai ekstensi, streaming, dan komponen akhir dari string nama file.

Sintaks

NTSTATUS FLTAPI FltParseFileName(
  [in]      PCUNICODE_STRING FileName,
  [in, out] PUNICODE_STRING  Extension,
  [in, out] PUNICODE_STRING  Stream,
  [in, out] PUNICODE_STRING  FinalComponent
);

Parameter

[in] FileName

Penunjuk ke struktur UNICODE_STRING yang berisi string untuk diurai sebagai nama file. Parameter ini diperlukan dan tidak boleh NULL.

[in, out] Extension

Penunjuk ke struktur UNICODE_STRING yang menerima ekstensi yang diurai dari string FileName . Jika tidak ada ekstensi yang ditemukan, FltParseFileName mengatur Extension.Buffer ke NULL dan Extension.Length ke nol. Jika tidak, Extension.Buffer menerima pointer ke awal ekstensi di FileName.Buffer, dan Extension.Length menerima panjang, dalam byte, ekstensi. Parameter ini bersifat opsional dan dapat berupa NULL.

[in, out] Stream

Penunjuk ke struktur UNICODE_STRING yang menerima nama aliran yang diurai dari string FileName . Jika tidak ada nama aliran yang ditemukan, FltParseFileName mengatur Stream. Buffer ke NULL dan Stream. Panjang hingga nol. Jika tidak, Stream. Buffer menerima penunjuk ke awal nama aliran di FileName.Buffer, dan Stream. Panjang menerima panjang, dalam byte, dari nama aliran. Parameter ini bersifat opsional dan dapat berupa NULL.

[in, out] FinalComponent

Penunjuk ke struktur UNICODE_STRING yang menerima komponen nama akhir yang diurai dari string FileName . Jika tidak ada komponen akhir yang ditemukan, FltParseFileName mengatur FinalComponent.Buffer ke NULL dan FinalComponent.Length ke nol. Jika tidak, FinalComponent.Buffer menerima penunjuk ke awal komponen akhir di FileName.Buffer, dan FinalComponent.Length menerima panjang, dalam byte, dari komponen akhir. Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

FltParseFileName mengembalikan STATUS_SUCCESS atau kode kesalahan NTSTATUS yang sesuai.

Keterangan

FltParseFileName mengurai ekstensi, nama aliran, dan komponen akhir dari string nama file. Nama file tidak diperlukan untuk dinormalisasi atau nama jalur lengkap. Jika nama file adalah nama file pendek, FltParseFileName hanya mengurai ekstensi.

Berikut ini adalah contoh nama yang dinormalisasi untuk file lokal:

\Device\HarddiskVolume1\Documents and Settings\MyUser\My Documents\Test Results.txt:stream1

FltParseFileName mengurai nama yang dinormalisasi ini sebagai berikut:

Ekstensi: "txt"

Stream: ":stream1"

FinalComponent: "Uji Results.txt:stream1"

Berikut ini adalah contoh nama pendek untuk file:

TestRe~1.txt

FltParseFileName mengurai nama pendek ini sebagai berikut:

Ekstensi: "txt"

Stream: NULL

FinalComponent: "TestRe~1.txt"

Untuk informasi selengkapnya tentang normalisasi nama file dan penguraian nama file, lihat FLT_FILE_NAME_INFORMATION.

Untuk mengurai konten struktur FLT_FILE_NAME_INFORMATION, panggil FltParseFileNameInformation.

Persyaratan

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

Lihat juga

FLT_FILE_NAME_INFORMATION

FltParseFileNameInformation

UNICODE_STRING