Rutinitas MRxQueryEaInfo
Rutinitas MRxQueryEaInfo dipanggil oleh RDBSS untuk meminta agar kueri pengalih mini jaringan memperluas informasi atribut pada objek sistem file.
Sintaks
PMRX_CALLDOWN MRxQueryEaInfo;
NTSTATUS MRxQueryEaInfo(
_Inout_ PRX_CONTEXT RxContext
)
{ ... }
Parameter
RxContext [masuk, keluar]
Penunjuk ke struktur RX_CONTEXT. Parameter ini berisi IRP yang meminta operasi.
Mengembalikan nilai
MRxQueryEaInfo 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_BUFFER_OVERFLOW | Buffer untuk menerima informasi atribut yang diperluas terlalu kecil. Nilai pengembalian ini harus dianggap berhasil dan sebanyak mungkin data yang valid harus dikembalikan dalam 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. |
| STATUS_EA_CORRUPT_ERROR | Informasi atribut yang diperluas tidak valid diterima dari server jarak jauh. |
| STATUS_INSUFFICIENT_RESOURCES | Tidak ada cukup sumber daya untuk menyelesaikan kueri. |
| STATUS_INVALID_PARAMETER | Parameter yang tidak valid ditentukan. |
| STATUS_NONEXISTENT_EA_ENTRY | Tidak ada atribut yang diperluas pada objek file dan pengguna menyediakan indeks atribut yang diperluas. |
| STATUS_NOT_SUPPORTED | Atribut yang diperluas tidak didukung. |
| STATUS_ONLY_IF_CONNECTED | Struktur SRV_OPEN tidak tersambung. |
| STATUS_REQUEST_ABORTED | Permintaan jaringan dibatalkan. |
Keterangan
RDBSS mengeluarkan panggilan ke MRxQueryEaInfo sebagai respons untuk menerima permintaan IRP_MJ_QUERY_EA .
Sebelum memanggil MRxQueryEaInfo, 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.QueryEa.Length>.
Anggota QueryEa.UserEaList diatur ke IrpSp-Parameters.QueryEa.EaList>.
Anggota QueryEa.UserEaListLength diatur ke IrpSp-Parameters.QueryEa.EaListLength>.
Anggota QueryEa.UserEaIndex diatur ke IrpSp-Parameters.QueryEa.EaIndex>.
Anggota QueryEa.RestartScan diatur ke nonzero jika IrpSp-Flags> memiliki SL_RESTART_SCAN bit aktif.
Anggota QueryEa.ReturnSingleEntry diatur ke nonzero jika IrpSp-Flags> memiliki bit SL_RETURN_SINGLE_ENTRY aktif.
Anggota QueryEa.IndexSpecified diatur ke nonzero jika IrpSp-Flags> memiliki bit SL_INDEX_SPECIFIED aktif.
Setelah berhasil, MRxQueryEaInfo harus mengatur anggota Info.LengthRemaining dari struktur RX_CONTEXT ke panjang informasi atribut yang diperluas yang dikembalikan dan juga memperbarui anggota Fobx-OffsetOfNextEaToReturn>. Jika panggilan ke MRxQueryEaInfo berhasil, RDBSS menetapkan anggota IoStatus.Information dari IRP ke IrpSp-Parameters.QueryEa.Length> dikurangi anggota Info.LengthRemaining dari RX_CONTEXT.
Persyaratan
Platform target |
Desktop |
Header |
Mrx.h (termasuk Mrx.h) |