Rutinitas MRxQueryQuotaInfo

Artikel
06/15/2023

Rutinitas MRxQueryQuotaInfo dipanggil oleh RDBSS untuk meminta informasi kuota kueri pengalih mini jaringan pada objek sistem file.

Sintaks

PMRX_CALLDOWN MRxQueryQuotaInfo;

NTSTATUS MRxQueryQuotaInfo(
  _Inout_ PRX_CONTEXT RxContext
)
{ ... }

Parameter

RxContext [masuk, keluar]
Penunjuk ke struktur RX_CONTEXT. Parameter ini berisi IRP yang meminta operasi.

Mengembalikan nilai

MRxQueryQuotaInfo mengembalikan STATUS_SUCCESS pada keberhasilan atau nilai NTSTATUS yang sesuai, seperti salah satu hal berikut ini:

Menampilkan kode	Deskripsi
STATUS_ACCESS_DENIED	Pemanggil tidak memiliki keamanan yang tepat untuk operasi ini.
STATUS_BUFFER_OVERFLOW	Buffer untuk menerima informasi kuota terlalu kecil. Nilai pengembalian ini harus dianggap berhasil dan sebanyak mungkin data yang valid harus dikembalikan di anggota Info.Buffer dari struktur RX_CONTEXT yang ditunjukkan oleh parameter RxContext .
STATUS_BUFFER_TOO_SMALL	Buffer terlalu kecil untuk menerima data yang diminta. Jika nilai ini dikembalikan, anggota InformationToReturn dari struktur RX_CONTEXT yang diacu oleh parameter RxContext harus diatur ke ukuran minimum buffer yang diharapkan agar panggilan berhasil.
STATUS_CONNECTION_DISCONNECTED	Sambungan terputus. Ini adalah kode kesalahan.
STATUS_INSUFFICIENT_RESOURCES	Sumber daya tidak cukup untuk menyelesaikan kueri. Ini adalah kode kesalahan.
STATUS_INVALID_PARAMETER	Parameter yang tidak valid ditentukan. Ini adalah kode kesalahan.
STATUS_NOT_SUPPORTED	Kuota tidak didukung.

Keterangan

RDBSS mengeluarkan panggilan ke MRxQueryQuotaInfo sebagai respons untuk menerima permintaan IRP_MJ_QUERY_QUOTA .

Sebelum memanggil MRxQueryQuotaInfo, RDBSS memodifikasi anggota berikut dalam struktur RX_CONTEXT yang ditujukkan oleh parameter RxContext :

Anggota Info.Buffer diatur ke buffer pengguna dari paket permintaan I/O. Buffer ini telah dikunci oleh RDBSS jika diperlukan.

Anggota Info.LengthRemaining diatur ke IrpSp-Parameters.QueryQuota.Length>.

Anggota QueryQuota.SidList diatur ke IrpSp-Parameters.QueryQuota.SidList>.

Anggota QueryQuota.SidListLength diatur ke IrpSp-Parameters.QueryQuota.SidListLength>.

Anggota QueryQuota.StartSid diatur ke IrpSp-Parameters.QueryQuota.StartSid>.

Anggota QueryQuota.Length diatur ke IrpSp-Parameters.QueryQuota.Length>.

Anggota QueryQuota.RestartScan diatur ke bukan nol jika IrpSp-Flags> memiliki set bit SL_RESTART_SCAN.

Anggota QueryQuota.ReturnSingleEntry diatur ke bukan nol jika IrpSp-Flags> memiliki set bit SL_RETURN_SINGLE_ENTRY.

Anggota QueryQuota.IndexSpecified diatur ke bukan nol jika IrpSp-Flags> memiliki set bit SL_INDEX_SPECIFIED.

Jika berhasil, pengalih mini jaringan harus mengatur anggota Info.LengthRemaining dari struktur RX_CONTEXT ke panjang informasi kuota yang akan dikembalikan. Jika panggilan ke MRxQueryQuotaInfo berhasil, RDBSS menetapkan anggota IoStatus.Information dari IRP ke anggota Info.LengthRemaining RX_CONTEXT.

Jika panggilan ke MRxQueryQuotaInfo berhasil, anggota InformationToReturn dari struktur RX_CONTEXT harus diatur ke panjang informasi kuota yang dikembalikan. Jika panggilan tidak berhasil, anggota InformationToReturn dari RX_CONTEXT harus diatur ke nol.