Fungsi FltQueryInformationByName (fltkernel.h)

  • Artikel

Rutinitas FltQueryInformationByName mengembalikan informasi yang diminta tentang file bernama.

Sintaks

NTSTATUS FLTAPI FltQueryInformationByName(
  [in]           PFLT_FILTER               Filter,
  [in, optional] PFLT_INSTANCE             Instance,
  [in]           POBJECT_ATTRIBUTES        ObjectAttributes,
  [out]          PIO_STATUS_BLOCK          IoStatusBlock,
  [out]          PVOID                     FileInformation,
  [in]           ULONG                     Length,
  [in]           FILE_INFORMATION_CLASS    FileInformationClass,
  [in, optional] PIO_DRIVER_CREATE_CONTEXT DriverContext
);

Parameter

[in] Filter

Menentukan filter yang memulai operasi ini.

[in, optional] Instance

Menentukan instans tempat pembuatan ditargetkan.

Penting

Instans belum tentu merupakan instans yang memulai. Ini harus cocok dengan instans tempat pembuatan ditargetkan, jika parameter ini non-NULL. Jika Instans bukan NULL, panggilan balik pra-buat filter saat ini tidak dipanggil. Pra-panggilan balik dimulai dengan filter di bawah filter saat ini.

[in] ObjectAttributes

Arahkan ke struktur [OBJECT_ATTRIBUTES] dengan atribut yang akan digunakan untuk objek file (misalnya, namanya, SECURITY_DESCRIPTOR, dll.).

[out] IoStatusBlock

Arahkan ke struktur IO_STATUS_BLOCK yang berisi blok status I/O penelepon.

[out] FileInformation

Penunjuk ke struktur yang menerima informasi yang diminta yang dikembalikan tentang file. Jenis struktur ditentukan oleh FileInformationClass.

[in] Length

Panjangnya, dalam byte, dari buffer FileInformation .

[in] FileInformationClass

Nilai enum FILE_INFORMATION_CLASS yang menentukan jenis informasi yang akan dikembalikan tentang file. Dapat berupa salah satu dari nilai berikut:

Nilai Jenis struktur yang dirujuk fileInformation
FileStatInformation FILE_STAT_INFORMATION
FileStatLxInformation **FILE_STAT_LX_INFORMATION
FileCaseSensitiveInformation FILE_CASE_SENSITIVE_INFORMATION. Pemanggil harus telah membuka file dengan bendera FILE_READ_ATTRIBUTES yang ditentukan dalam parameter DesiredAccess. Nilai ini tersedia dimulai dengan Windows 10, versi 1803.
FileCaseSensitiveInformationForceAccessCheck FILE_CASE_SENSITIVE_INFORMATION. Ini adalah versi khusus dari operasi FileCaseSensitiveInformation yang digunakan untuk memaksa Manajer IO melakukan pemeriksaan akses untuk driver mode kernel, mirip dengan pemeriksaan yang berlaku untuk pemanggil mode pengguna. Operasi ini hanya dikenali oleh Manajer IO dan sistem file tidak boleh menerimanya. Nilai ini tersedia dimulai dengan Windows 10, versi 1803.

[in, optional] DriverContext

Penunjuk ke ruang konteks driver.

Mengembalikan nilai

Mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, mengembalikan kode kesalahan NTSTATUS yang sesuai.

Keterangan

Fungsi ini mengembalikan informasi yang diminta tentang file tanpa membuka file aktual. Informasi yang dikembalikan ditentukan oleh FileInformationClass yang ditentukan, dan ditempatkan ke dalam buffer FileInformation pemanggil.

Jika Instansnon-NULL , pembuatan akan ditargetkan ke instans yang ditentukan, memanggil semua filter di bawah filter saat ini sebelum mengirim I/O ke bawah. Jika InstansNULL, I/O akan selalu dikirim ke bagian atas tumpukan filter.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10, versi 1706
Header fltkernel.h
Pustaka FltMgr.lib
DLL Fltmgr.sys

Lihat juga

FILE_INFORMATION_CLASS