Fungsi ZwQueryQuotaInformationFile (ntifs.h)
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) |
Lihat juga
Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli