Rutinitas MRxQueryDirectory

Artikel
02/07/2024

Rutinitas MRxQueryDirectory dipanggil oleh RDBSS untuk meminta informasi kueri pengalihan mini jaringan pada direktori file.

Sintaks

PMRX_CALLDOWN MRxQueryDirectory;

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

Parameter

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

Mengembalikan nilai

MRxQueryDirectory mengembalikan STATUS_SUCCESS 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_INSUFFICIENT_RESOURCES	Tidak ada cukup sumber daya untuk menyelesaikan kueri.
STATUS_INVALID_NETWORK_RESPONSE	Buffer informasi file yang tidak valid diterima dari server jarak jauh atau panjang nama file yang dikembalikan melebihi panjang maksimum yang diizinkan.
STATUS_INVALID_PARAMETER	FileInformationClass yang tidak valid ditentukan dalam anggota Info.FileInformationClass dalam struktur RX_CONTEXT yang diacu oleh parameter RxContext .
STATUS_LINK_FAILED	Upaya untuk menyambungkan kembali ke server jarak jauh untuk menyelesaikan kueri gagal.
STATUS_NO_SUCH_FILE	Kueri gagal menemukan entri apa pun.
STATUS_SHARING_VIOLATION	Terjadi pelanggaran berbagi.

Keterangan

Sebelum memanggil MRxQueryDirectory, RDBSS memodifikasi anggota berikut dalam struktur RX_CONTEXT yang diarahkan oleh parameter RxContext :

Anggota Info.FileInformationClass diatur ke IrpSp-Parameters.QueryDirectory.FileInformationClass>.

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.QueryDirectory.Length>.

Anggota QueryDirectory.FileIndex diatur ke IrpSp-Parameters.QueryDirectory.FileIndex>.

Anggota QueryDirectory.RestartScan diatur ke nonzero jika IrpSp-Flags> memiliki bit SL_RESTART_SCAN aktif.

Anggota QueryDirectory.ReturnSingleEntry diatur ke nonzero jika IrpSp-Flags> memiliki bit SL_RETURN_SINGLE_ENTRY aktif.

Anggota QueryDirectory.IndexSpecified diatur ke nonzero jika IrpSp-Flags> memiliki bit SL_INDEX_SPECIFIED aktif.

Anggota QueryDirectory.InitialQuery diatur ke bukan nol jika unicodeQueryTemplate.Buffer anggota FOBX terkait adalah NULL dan anggota Bendera FOBX tidak memiliki bit FOBX_FLAG_MATCH_ALL aktif.

Untuk kueri wild card ("*.*", misalnya), RDBSS akan mengatur anggota UnicodeQueryTemplate.Buffer dari FOBX terkait ke kueri wild card yang diteruskan.

Jika anggota PostRequest dari struktur RX_CONTEXT TRUE saat dikembalikan dari MRxQueryDirectory, maka RDBSS akan memanggil RxFsdPostRequest yang meneruskan struktur RX_CONTEXT ke antrean pekerja untuk diproses oleh proses sistem file (FSP).