Fungsi ZwQueryQuotaInformationFile (ntifs.h)

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

Sintaksis

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

[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 di 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 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.

Mengembalikan nilai

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:

Komentar

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.

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

Lihat juga

FILE_GET_QUOTA_INFORMATION

FILE_QUOTA_INFORMATION

IO_STATUS_BLOCK

IRP_MJ_QUERY_QUOTA

IRP_MJ_SET_QUOTA

IoCheckQuotaBufferValidity

Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli

ZwSetQuotaInformationFile