Fungsi NtSetQuotaInformationFile (ntifs.h)

Artikel
08/07/2023

Entri kuota perubahan rutin NtSetQuotaInformationFile untuk volume yang terkait dengan parameter FileHandle . Semua entri kuota dalam buffer yang ditentukan diterapkan ke volume.

Sintaks

__kernel_entry NTSYSCALLAPI NTSTATUS NtSetQuotaInformationFile(
  [in]  HANDLE           FileHandle,
  [out] PIO_STATUS_BLOCK IoStatusBlock,
  [in]  PVOID            Buffer,
  [in]  ULONG            Length
);

Parameter

[in] FileHandle

Handel untuk objek file yang mewakili file atau volume yang informasi kuotanya akan dimodifikasi.

[out] IoStatusBlock

Alamat blok status I/O pemanggil.

[in] Buffer

Buffer yang berisi entri kuota baru yang harus diterapkan ke volume. Informasi kuota harus diformat sebagai satu atau beberapa struktur FILE_QUOTA_INFORMATION . Bidang NextEntryOffset dalam struktur FILE_QUOTA_INFORMATION berisi offset, dalam byte, dari entri kuota berikutnya dalam daftar. Jika tidak ada entri lagi setelah entri saat ini, anggota ini adalah nol.

[in] Length

Panjang dalam byte buffer.

Nilai kembali

Rutinitas NtSetQuotaInformationFile mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai seperti salah satu hal berikut ini:

Menampilkan kode	Deskripsi
STATUS_INSUFFICIENT_RESOURCES	Tidak ada cukup sumber daya untuk menyelesaikan operasi. Ini adalah kode kesalahan.
STATUS_INVALID_DEVICE_REQUEST	Kuota tidak diaktifkan pada volume. Ini adalah kode kesalahan.
STATUS_MEDIA_WRITE_PROTECTED	Volume hanya dibaca. Ini adalah kode kesalahan.

Keterangan

Rutinitas NtSetQuotaInformationFile menerapkan semua entri kuota dalam parameter Buffer yang ditentukan ke volume.

Fungsi IoCheckQuotaBufferValidity dapat memeriksa apakah buffer kuota yang ditentukan diteruskan sebagai parameter Buffer valid.

Panggilan ke NtSetQuotaInformationFile akan mengakibatkan permintaan IRP_MJ_SET_QUOTA dikirim ke objek perangkat yang terkait dengan objek file yang handelnya disimpan dalam parameter FileHandle .

Jika sistem file yang mendasar tidak mendukung informasi kuota (sistem file FAT dan CDFS, misalnya), NtSetQuotaInformationFile akan gagal mengembalikan STATUS_INVALID_DEVICE_REQUEST.

Catatan

Jika panggilan ke fungsi NtSetQuotaInformationFile terjadi dalam mode kernel, Anda harus menggunakan nama "[ZwSetQuotaInformationFile](nf-ntifs-zwsetquotainformationfile.md" alih-alih "NtSetQuotaInformationFile".

Untuk panggilan dari driver mode kernel, versi NtXxx dan ZwXxx dari rutinItas Windows Native System Services dapat berperilaku berbeda dalam cara mereka menangani dan menginterpretasikan parameter input. Untuk informasi selengkapnya tentang hubungan antara versi NtXxx dan ZwXxx dari rutinitas, lihat Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7
Target Platform	Universal
Header	ntifs.h (termasuk Ntifs.h, FltKernel.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs, PowerIrpDDis