Fungsi FltQueryInformationFile (fltkernel.h)

  • Artikel

FltQueryInformationFile mengambil informasi untuk file tertentu.

Sintaks

NTSTATUS FLTAPI FltQueryInformationFile(
  [in]            PFLT_INSTANCE          Instance,
  [in]            PFILE_OBJECT           FileObject,
  [out]           PVOID                  FileInformation,
  [in]            ULONG                  Length,
  [in]            FILE_INFORMATION_CLASS FileInformationClass,
  [out, optional] PULONG                 LengthReturned
);

Parameter

[in] Instance

Penunjuk instans buram untuk pemanggil. Parameter ini diperlukan dan tidak boleh NULL.

[in] FileObject

Penunjuk objek file untuk file. Parameter ini diperlukan dan tidak boleh NULL.

[out] FileInformation

Arahkan ke buffer yang dialokasikan penelepon yang menerima informasi tentang file. Parameter FileInformationClass menentukan jenis informasi. Parameter ini diperlukan dan tidak boleh NULL.

[in] Length

Ukuran, dalam byte, dari buffer FileInformation .

[in] FileInformationClass

Nilai FILE_INFORMATION_CLASS yang menentukan jenis informasi file yang akan dikembalikan dalam buffer FileInformation .

[out, optional] LengthReturned

Penunjuk ke variabel yang dialokasikan penelepon yang menerima ukuran, dalam byte, dari informasi yang dikembalikan dalam buffer FileInformation . Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

FltQueryInformationFile mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai seperti berikut ini:

Menampilkan kode Deskripsi
STATUS_VOLUME_DISMOUNTED
 File berada pada volume yang saat ini tidak dipasang. Ini adalah kode kesalahan.

Keterangan

Driver minifilter memanggil FltQueryInformationFile untuk mengambil informasi untuk file yang diidentifikasi oleh FileObject. File saat ini harus dibuka.

FltQueryInformationFile mengembalikan nol dalam anggota struktur FILE_XXX_INFORMATION yang tidak didukung oleh sistem file tertentu.

Pemanggil FltQueryInformationFile harus berjalan di IRQL = PASSIVE_LEVEL dan dengan APC diaktifkan.

CATATAN: Jangan panggil rutinitas ini dengan nilai IRP tingkat atas non-NULL, karena ini dapat menyebabkan kebuntuan sistem.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header fltkernel.h (termasuk Fltkernel.h)
Pustaka FltMgr.lib
DLL Fltmgr.sys
IRQL PASSIVE_LEVEL (lihat bagian Keterangan)

Lihat juga

FILE_INFORMATION_CLASS

FltQueryVolumeInformationFile

FltSetInformationFile

ZwQueryInformationFile