Fungsi ZwSetQuotaInformationFile (ntifs.h)
ZwSetQuotaInformationFile rutin mengubah entri kuota untuk volume yang terkait dengan parameter FileHandle. Semua entri kuota dalam buffer yang ditentukan diterapkan ke volume.
Sintaks
NTSYSAPI NTSTATUS ZwSetQuotaInformationFile(
[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 penelepon.
[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 ZwSetQuotaInformationFile 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 bersifat baca-saja. Ini adalah kode kesalahan. |
Keterangan
Rutinitas ZwSetQuotaInformationFile 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 ZwSetQuotaInformationFile 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), ZwSetQuotaInformationFile akan gagal mengembalikan STATUS_INVALID_DEVICE_REQUEST.
Catatan
Jika panggilan ke fungsi ZwSetQuotaInformationFile terjadi dalam mode pengguna, Anda harus menggunakan nama "NtSetQuotaInformationFile" alih-alih "ZwSetQuotaInformationFile".
Untuk panggilan dari driver mode kernel, versi NtXxx dan ZwXxx dari rutinitas Windows Native System Services dapat berperilaku berbeda dalam cara mereka menangani dan menafsirkan 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(storport), PowerIrpDDis(wdm) |
Lihat juga
Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk