Fungsi ZwQueryQuotaInformationFile (ntifs.h)

Artikel
08/07/2023

Rutinitas ZwQueryQuotaInformationFile mengambil entri kuota yang terkait dengan volume yang ditentukan oleh parameter FileHandle .

Sintaks

NTSYSAPI NTSTATUS ZwQueryQuotaInformationFile(
  [in]           HANDLE           FileHandle,
  [out]          PIO_STATUS_BLOCK IoStatusBlock,
  [out]          PVOID            Buffer,
  [in]           ULONG            Length,
  [in]           BOOLEAN          ReturnSingleEntry,
  [in, optional] PVOID            SidList,
  [in]           ULONG            SidListLength,
  [in, optional] PSID             StartSid,
  [in]           BOOLEAN          RestartScan
);

Parameter

[in] FileHandle

Handel untuk objek file yang mewakili file atau volume yang informasi kuotanya diminta.

[out] IoStatusBlock

Alamat blok status I/O penelepon.

[out] Buffer

Buffer untuk menerima informasi kuota untuk volume. Informasi kuota 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.

[in] ReturnSingleEntry

Nilai Boolean yang menunjukkan apakah hanya satu entri yang harus dikembalikan daripada mengisi buffer dengan entri sebanyak mungkin.

[in, optional] SidList

Daftar opsional SID yang informasi kuotanya akan dikembalikan. Setiap entri dalam daftar adalah struktur FILE_GET_QUOTA_INFORMATION . Bidang NextEntryOffset dalam struktur FILE_GET_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] SidListLength

Panjang dalam byte daftar SID , jika ditentukan.

[in, optional] StartSid

Penunjuk opsional ke SID entri untuk mulai memindai informasi kuota. Parameter ini harus diatur jika informasi yang dikembalikan adalah memulai dengan entri selain SID pertama. Parameter ini diabaikan jika parameter SidList ditentukan.

[in] RestartScan

Nilai Boolean yang menunjukkan apakah pemindaian informasi kuota akan dimulai ulang dari awal. Atur parameter ini ke TRUE jika pemindaian informasi kuota dimulai pada entri pertama dalam daftar informasi kuota volume. Atur ke FALSE jika melanjutkan pemindaian dari panggilan sebelumnya ke ZwQueryQuotaInformationFile. Pemanggil harus mengatur parameter ini ke TRUE saat memanggil ZwQueryQuotaInformationFile untuk pertama kalinya.

Nilai kembali

Rutinitas ZwQueryQuotaInformationFile mengembalikan STATUS_SUCCESS jika setidaknya satu struktur FILE_QUOTA_INFORMATION dikembalikan dalam parameter Buffer atau nilai NTSTATUS yang sesuai seperti salah satu dari 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_INVALID_SID	Parameter StartSid tidak berisi SID yang valid. Ini adalah kode kesalahan.
STATUS_QUOTA_LIST_INCONSISTENT	Parameter SidList tidak berisi daftar yang valid dan terbentuk dengan benar. Ini adalah kode kesalahan.

Keterangan

Jumlah informasi yang dikembalikan oleh ZwQueryQuotaInformationFile didasarkan pada ukuran informasi kuota yang terkait dengan volume, ukuran buffer, dan apakah sekumpulan entri tertentu telah diminta.

Panggilan ke ZwQueryQuotaInformationFile 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), ZwQueryQuotaInformationFile akan gagal mengembalikan STATUS_INVALID_DEVICE_REQUEST.

Catatan

Jika panggilan ke fungsi ZwQueryQuotaInformationFile terjadi dalam mode pengguna, Anda harus menggunakan nama "NtQueryQuotaInformationFile" alih-alih "ZwQueryQuotaInformationFile".

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)