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) |