Fungsi RxCreateVNetRoot (fcb.h)
RxCreateVNetRoot mengalokasikan dan menginisialisasi struktur NET_ROOT dan menyisipkan nama ke dalam tabel nama bersih pada objek perangkat terkait.
Sintaks
PV_NET_ROOT RxCreateVNetRoot(
[in] IN PRX_CONTEXT RxContext,
[in] IN PNET_ROOT NetRoot,
[in] IN PUNICODE_STRING CanonicalName,
[in] IN PUNICODE_STRING LocalNetRootName,
[in] IN PUNICODE_STRING FilePath,
[in] IN PRX_CONNECTION_ID RxConnectionId
);
Parameter
[in] RxContext
Penunjuk ke RX_CONTEXT RDBSS yang berisi IRP yang menjelaskan operasi buat.
[in] NetRoot
Penunjuk ke struktur NET_ROOT terkait.
[in] CanonicalName
Penunjuk ke nama kanonis yang akan disisipkan dalam tabel nama.
[in] LocalNetRootName
Penunjuk ke nama NET_ROOT lokal tanpa nama awalan.
[in] FilePath
Penunjuk ke nama jalur file. Parameter ini saat ini tidak digunakan dan dapat berupa NULL.
[in] RxConnectionId
Penunjuk ke ID koneksi yang akan dikaitkan dengan nama yang akan disisipkan dalam tabel nama awalan. Parameter ini bisa NULL dalam hal ini tidak ada ID koneksi yang akan dikaitkan dengan nama yang disisipkan dalam tabel nama.
Nilai kembali
RxCreateVNetRoot mengembalikan pointer ke struktur data V_NET_ROOT yang baru dibuat saat berhasil atau pointer NULL gagal.
Keterangan
Rutinitas RxCreateVNetRoot biasanya tidak dipanggil oleh driver mini-redirector jaringan secara langsung. RDBSS memanggil rutinitas ini secara internal ketika paket permintaan I/O diterima untuk IRP_MJ_CREATE dan V_NET_ROOT perlu dibuat. IRP ini biasanya diterima oleh RDBSS sebagai respons terhadap aplikasi mode pengguna yang meminta operasi pembuatan file pada berbagi jaringan. Dimungkinkan juga bagi driver kernel lain untuk mengeluarkan IRP seperti itu.
Sebelum memanggil RxCreateVNetRoot, kunci pada tabel nama yang terkait dengan anggota objek perangkat parameter RxContext harus diperoleh dalam mode eksklusif.
RxCreateVNetRoot menetapkan berbagai parameter konteks keamanan pada struktur V_NET_ROOT berdasarkan parameter dari RX_CONTEXT. Parameter ini mencakup yang berikut: LogonId, SessionId, pUserName, pUserDomainName, pPassword, dan Flags.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Desktop |
Header | fcb.h (termasuk Rxcontx.h, Mrxfcb.h, Prefix.h, Struchdr.h, Fcb.h) |
IRQL | <= APC_LEVEL |