Fungsi ZwSetQuotaInformationFile (ntifs.h)

Artikel
12/21/2024

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

Sintaksis

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 tempat informasi kuota 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 di 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 byte buffer.

Mengembalikan nilai

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

Mengembalikan kode	Deskripsi
STATUS_INSUFFICIENT_RESOURCES	Ada sumber daya yang tidak cukup 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.

Komentar

ZwSetQuotaInformationFile rutin 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.

Nota

Jika panggilan ke fungsi ZwSetQuotaInformationFile terjadi dalam mode pengguna, Anda harus menggunakan nama "NtSetQuotaInformationFile" bukan "ZwSetQuotaInformationFile".

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

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 7
Platform Target	Universal
Header	ntifs.h (termasuk Ntifs.h, FltKernel.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
aturan kepatuhan DDI	HwStorPortProhibitedDIs (storport), PowerIrpDDis(wdm)