Fungsi RxCreateNetRoot (fcb.h)

Artikel
02/26/2024

RxCreateNetRoot mengalokasikan dan menginisialisasi struktur NET_ROOT dan menyisipkan nama ke dalam tabel nama bersih pada objek perangkat terkait.

Sintaks

PNET_ROOT RxCreateNetRoot(
  [in]           IN PSRV_CALL         SrvCall,
  [in]           IN PUNICODE_STRING   Name,
  [in]           IN ULONG             NetRootFlags,
  [in, optional] IN PRX_CONNECTION_ID RxConnectionId
);

Parameter

[in] SrvCall

Penunjuk ke struktur SRV_CALL terkait.

[in] Name

Penunjuk ke nama yang akan disisipkan dalam tabel nama.

[in] NetRootFlags

Nilai untuk mengatur anggota Bendera dari NET_ROOT yang digunakan untuk menunjukkan status struktur NET_ROOT.

[in, optional] 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 awalan.

Nilai kembali

RxCreateNetRoot mengembalikan pointer ke struktur data NET_ROOT yang baru dibuat saat berhasil atau pointer NULL gagal.

Keterangan

Rutinitas RxCreateNetRoot biasanya tidak dipanggil oleh driver pengalih mini jaringan secara langsung. RDBSS memanggil rutinitas ini secara internal ketika paket permintaan I/O diterima untuk IRP_MJ_CREATE dan 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 RxCreateNetRoot, kunci pada tabel nama yang terkait dengan anggota objek perangkat parameter SrvCall harus diperoleh dalam mode eksklusif.

Bendera NET_ROOT dibagi menjadi dua grup, yang terlihat oleh pengalih mini jaringan dan bendera yang tidak terlihat oleh pengalih mini jaringan. Yang terlihat adalah 16-bit yang lebih rendah dari anggota Bendera NET_ROOT. Rutinitas ini tidak memeriksa atau menguji bendera mana yang sedang ditetapkan.

Jika berhasil, jumlah referensi untuk struktur SRV_CALL bertahap.