Rutinitas MRxQuerySdInfo
RutinitasMRxQuerySdInfo dipanggil oleh RDBSS untuk meminta informasi pendeskripsi keamanan kueri pengalih mini jaringan pada objek sistem file.
Sintaks
PMRX_CALLDOWN MRxQuerySdInfo;
NTSTATUS MRxQuerySdInfo(
_Inout_ PRX_CONTEXT RxContext
)
{ ... }
Parameter
RxContext [masuk, keluar]
Penunjuk ke struktur RX_CONTEXT. Parameter ini berisi IRP yang meminta operasi.
Mengembalikan nilai
MRxQuerySdInfo 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 pendeskripsi keamanan 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. |
| STATUS_INSUFFICIENT_RESOURCES | Sumber daya tidak cukup untuk menyelesaikan kueri. |
| STATUS_INVALID_PARAMETER | Parameter yang tidak valid ditentukan. |
| STATUS_NETWORK_ACCESS_DENIED | Akses jaringan ditolak. |
| STATUS_NOT_IMPLEMENTED | Fitur yang diminta, seperti informasi pada file halaman jarak jauh, tidak diimplementasikan. |
| STATUS_NOT_SUPPORTED | Informasi deskriptor keamanan tidak didukung pada berbagi jarak jauh. |
| STATUS_OBJECT_PATH_NOT_FOUND | Jalur objek tidak ditemukan. Kesalahan ini dapat dikembalikan jika informasi pada objek aliran NTFS diminta dan sistem file jarak jauh tidak mendukung aliran. |
| STATUS_REPARSE | Penguraian ulang diperlukan untuk menangani tautan simbolis. |
Keterangan
RDBSS mengeluarkan panggilan ke MRxQuerySdInfo sebagai respons untuk menerima permintaan IRP_MJ_QUERY_SECURITY .
Sebelum memanggil MRxQuerySdInfo, RDBSS memodifikasi anggota berikut dalam struktur RX_CONTEXT yang ditujukkan oleh parameter RxContext :
Anggota QuerySecurity.SecurityInformation diatur ke IrpSp-Parameters.QuerySecurity.SecurityInformation>.
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.QuerySecurity.Length>.
Jika berhasil, pengalih mini jaringan harus mengatur anggota InformationToReturn dari struktur RX_CONTEXT ke panjang informasi keamanan yang dikembalikan. Jika panggilan ke MRxQuerySdInfo berhasil, RDBSS menetapkan anggota IoStatus.Information dari IRP ke anggota InformationToReturn dari RX_CONTEXT.
Persyaratan
Platform target |
Desktop |
Header |
Mrx.h (termasuk Mrx.h) |