Fungsi FltSetInformationFile (fltkernel.h)

Artikel
02/26/2024

FltSetInformationFile menetapkan informasi untuk file tertentu.

Sintaks

NTSTATUS FLTAPI FltSetInformationFile(
  [in] PFLT_INSTANCE          Instance,
  [in] PFILE_OBJECT           FileObject,
  [in] PVOID                  FileInformation,
  [in] ULONG                  Length,
  [in] FILE_INFORMATION_CLASS FileInformationClass
);

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.

[in] FileInformation

Penunjuk ke buffer yang dialokasikan penelepon yang berisi informasi yang akan diatur untuk file. Parameter FileInformationClass menentukan jenis informasi. Parameter ini diperlukan dan tidak boleh NULL.

[in] Length

Ukuran, dalam byte, dari buffer FileInformation .

[in] FileInformationClass

Menentukan tipe informasi yang akan disetel untuk file. Nilai berikut ditentukan.

Nilai	Makna
FileAllocationInformation	Atur FILE_ALLOCATION_INFORMATION untuk file.
FileBasicInformation	Atur FILE_BASIC_INFORMATION untuk file.
FileDispositionInformation	Atur FILE_DISPOSITION_INFORMATION untuk file.
FileEndOfFileInformation	Atur FILE_END_OF_FILE_INFORMATION untuk file.
FileLinkInformation	Atur FILE_LINK_INFORMATION untuk file.
FilePositionInformation	Atur FILE_POSITION_INFORMATION untuk file.
FileRenameInformation	Atur FILE_RENAME_INFORMATION untuk file. Untuk informasi selengkapnya tentang penggantian nama file, lihat bagian Keterangan berikut ini.
FileValidDataLengthInformation	Atur FILE_VALID_DATA_LENGTH_INFORMATION untuk file.

Nilai kembali

FltSetInformationFile mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai.

Keterangan

Driver minifilter memanggil FltSetInformationFile untuk mengatur informasi untuk file tertentu. File saat ini harus dibuka.

Operasi penggantian nama file memberlakukan pembatasan berikut pada nilai parameter yang diteruskan ke FltSetInformationFile: Seperti yang disebutkan dalam entri referensi untuk FILE_RENAME_INFORMATION, file atau direktori hanya dapat diganti namanya dalam volume. Dengan kata lain, operasi ganti nama tidak dapat menyebabkan file atau direktori dipindahkan ke volume yang berbeda. Tidak seperti ZwSetInformationFile, FltSetInformationFile tidak memvalidasi konten struktur FILE_RENAME_INFORMATION. Dengan demikian pemanggil FltSetInformationFile bertanggung jawab untuk memastikan bahwa nama baru untuk file atau direktori berada pada volume yang sama dengan nama lama.

Driver minifilter harus menggunakan FltSetInformationFile , bukan ZwSetInformationFile, untuk mengganti nama file.