Fungsi RxCreateVNetRoot (fcb.h)

Artikel
08/07/2023

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.