Fungsi RxCreateNetFcb (fcb.h)

Artikel
03/01/2024

RxCreateNetFCB mengalokasikan, menginisialisasi, dan menyisipkan struktur FCB baru ke dalam struktur data dalam memori untuk V_NET_ROOT bahwa FCB ini sedang dibuka. Struktur yang dialokasikan memiliki ruang untuk SRV_OPEN dan struktur FOBX.

Sintaks

PFCB RxCreateNetFcb(
  [in] IN PRX_CONTEXT     RxContext,
  [in] IN PIRP            Irp,
  [in] IN PV_NET_ROOT     VNetRoot,
  [in] IN PUNICODE_STRING Name
);

Parameter

[in] RxContext

Penunjuk ke struktur RX_CONTEXT yang menjelaskan operasi buat.

[in] Irp

Penunjuk ke IRP yang dienkapsulasi oleh struktur RX_CONTEXT ini.

[in] VNetRoot

Penunjuk ke struktur V_NET_ROOT tempat FCB ini dibuka.

[in] Name

Nama FCB. V_NET_ROOT mungkin berisi awalan nama yang akan ditambahkan sebelumnya di sini.

Nilai kembali

RxCreateNetFCB mengembalikan pointer ke struktur data FCB yang baru dialokasikan saat berhasil atau pointer NULL gagal.

Keterangan

Rutinitas RxCreateNetFCB 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 struktur FCB 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.

Jika FCB yang akan dibuat adalah file halaman, RxCreateNetFCB mengalokasikan memori kumpulan non-halaman saat membuat struktur data FCB baru dan mengatur bendera berikut pada anggota FcbState FCB:

Jika FCB yang akan dibuat bukan file halaman, RxCreateNetFCB mengalokasikan memori kumpulan halaman saat membuat struktur data FCB baru.

Windows saat ini tidak memperbolehkan berkas halaman pada komputer jarak jauh.

Jika anggota Create.Flags di RX_CONTEXT memiliki bendera RX_CONTEXT_CREATE_FLAG_ADDEDBACKSLASH aktif, anggota FcbState FCB memiliki bendera FCB_STATE_ADDEDBACKSLASH yang diatur.