Fungsi IoCheckQuerySetFileInformation (ntifs.h)

Rutinitas IoCheckQuerySetFileInformation memeriksa validitas parameter untuk kueri atau mengatur operasi informasi file.

Sintaks

NTSTATUS IoCheckQuerySetFileInformation(
  FILE_INFORMATION_CLASS FileInformationClass,
  ULONG                  Length,
  BOOLEAN                SetOperation
);

Parameter

FileInformationClass

Nilai enum FILE_INFORMATION_CLASS yang menentukan kelas informasi file yang akan diperiksa.

Length

Ukuran, dalam byte, dari buffer yang diperlukan untuk operasi informasi file yang ditentukan.

SetOperation

Nilai Boolean yang menentukan jenis operasi. Jika SetOperationTRUE, operasinya adalah operasi file yang ditetapkan; jika FALSE, ini adalah operasi file kueri.

Nilai kembali

IoCheckQuerySetFileInformation mengembalikan STATUS_SUCCESS jika parameter valid; jika tidak, ia mengembalikan salah satu kode kesalahan berikut.

Kode Pengembalian	Deskripsi
STATUS_INVALID_INFO_CLASS	Nilai yang ditentukan dalam FileInformationClass bukan kelas informasi yang valid.
STATUS_INFO_LENGTH_MISMATCH	Ukuran buffer yang ditentukan dalam Panjang lebih kecil dari ukuran buffer yang diperlukan untuk operasi file yang ditentukan.

Keterangan

IoCheckQuerySetFileInformation digunakan terutama oleh server jaringan yang berjalan dalam mode kernel karena tidak ada pemeriksaan validitas parameter tersebut yang dilakukan di jalur normal.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	ntifs.h (termasuk Ntifs.h)

Lihat juga

FILE_INFORMATION_CLASS

ZwQueryInformationFile

ZwSetInformationFile