Fungsi RxCreateSrvOpen (fcb.h)

Artikel
02/29/2024

RxCreateSrvOpen mengalokasikan, menginisialisasi, dan menyisipkan struktur SRV_OPEN baru ke dalam struktur data dalam memori yang digunakan oleh RDBSS. Jika struktur baru harus dialokasikan, struktur FOBX memiliki ruang untuk struktur FOBX.

Sintaks

PSRV_OPEN RxCreateSrvOpen(
  [in]      IN PV_NET_ROOT VNetRoot,
  [in, out] IN OUT PFCB    Fcb
);

Parameter

[in] VNetRoot

Penunjuk ke struktur V_NET_ROOT.

[in, out] Fcb

Penunjuk ke struktur FCB terkait.

Nilai kembali

RxCreateSrvOpen mengembalikan pointer ke struktur data SRV_OPEN yang baru dibuat saat berhasil atau pointer NULL gagal.

Keterangan

Rutinitas RxCreateSrvOpen 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 SRV_OPEN 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 RxCreateSrvOpen, kunci pada struktur FCB terkait harus diperoleh dalam mode eksklusif.

RxCreateSrvOpen akan mencoba dan menggunakan SRV_CALL yang dialokasikan sebagai bagian dari struktur FCB terkait jika tersedia. Jika SRV_CALL yang dialokasikan dengan FCB tidak tersedia, RxCreateSrvOpen akan mengalokasikan struktur SRV_CALL baru.

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

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