Fungsi RxCreateNetFobx (fcb.h)

Artikel
02/29/2024

RxCreateNetFobx mengalokasikan, menginisialisasi, dan menyisipkan struktur ekstensi objek file (FOBX) baru ke dalam struktur data dalam memori untuk FCB tempat FOBX ini dibuka.

Sintaks

PMRX_FOBX RxCreateNetFobx(
  [out] OUT PRX_CONTEXT  RxContext,
  [in]  IN PMRX_SRV_OPEN MrxSrvOpen
);

Parameter

[out] RxContext

Penunjuk ke struktur RX_CONTEXT yang menjelaskan operasi buat.

[in] MrxSrvOpen

Penunjuk ke struktur SRV_OPEN terkait.

Nilai kembali

RxCreateNetFobx mengembalikan pointer ke struktur data FOBX yang baru dialokasikan saat berhasil atau pointer NULL gagal.

Keterangan

Pengalih mini jaringan harus memanggil RxCreateNetFobx untuk membuat FOBX di akhir operasi pembuatan yang berhasil.

Sebelum memanggil RxCreateNetFobx, FCB yang terkait dengan struktur FOBX harus diperoleh dalam mode eksklusif.

RxCreateNetFobx akan mencoba dan menggunakan FOBX yang dialokasikan sebagai bagian dari struktur FCB terkait jika tersedia. Jika FOBX yang dialokasikan dengan FCB tidak tersedia, RxCreateNetFobx akan mencoba dan menggunakan FOBX yang dialokasikan sebagai bagian dari struktur SRV_OPEN terkait jika tersedia. Dalam salah satu kasus ini, RxCreateNetFobx hanya perlu menginisialisasi struktur FOBX yang ada, tidak diperlukan alokasi memori. Jika kedua struktur FOBX pada FCB terkait dan struktur SRV_OPEN tidak tersedia, maka RxCreateNetFobx akan mengalokasikan struktur FOBX baru.

Jika FCB terkait adalah file halaman, RxCreateNetFobx mengalokasikan memori kumpulan non-halaman saat membuat struktur data FOBX baru. Jika FCB terkait bukan file halaman, RxCreateNetFobx mengalokasikan memori kumpulan halaman saat membuat struktur data FOBX baru.

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

Setelah berhasil, anggota FOBX berikut dalam struktur FOBX diatur:

Anggota NodeReference diatur ke 1.
Anggota FobxSerialNumber diatur ke 0.
Anggota SrvOpen diatur ke struktur SRV_OPEN terkait.
Anggota fOpenCountDecremented diatur ke FALSE.
Anggota Bendera diatur ke nilai berdasarkan parameter dari RX_CONTEXT dan apakah FOBX baru perlu dialokasikan.