Fungsi RxCreateSrvCall (fcb.h)

Artikel
03/01/2024

RxCreateSrvCall membangun struktur SRV_CALL dan menyisipkan nama ke dalam tabel nama bersih yang dikelola oleh RDBSS.

Sintaks

PSRV_CALL RxCreateSrvCall(
  IN PRX_CONTEXT       RxContext,
  IN PUNICODE_STRING   Name,
  IN PUNICODE_STRING   InnerNamePrefix,
  IN PRX_CONNECTION_ID RxConnectionId
);

Parameter

RxContext

[in] Penunjuk ke struktur RX_CONTEXT yang berisi IRP yang menjelaskan operasi buat.

Name

[in] Penunjuk ke nama yang akan disisipkan dalam tabel nama.

InnerNamePrefix

Penunjuk ke nama awalan dalam opsional untuk disisipkan ke dalam tabel nama dengan Nama.

RxConnectionId

[in] 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 dimasukkan dalam tabel nama awalan.

Nilai kembali

RxCreateSrvCall mengembalikan penunjuk ke struktur data SRV_CALL yang baru dibuat saat berhasil atau penunjuk NULL gagal.

Keterangan

Rutinitas RxCreateSrvCall 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_CALL 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 RxCreateSrvCall, kunci pada tabel nama yang terkait dengan anggota objek perangkat parameter RxContext harus diperoleh dalam mode eksklusif.

RxCreateSrvCall menginisialisasi parameter panggilan server yang diteruskan melalui atribut yang diperluas sebagai bagian dari struktur RX_CONTEXT terkait. Saat ini termasuk menginisialisasi anggota pPrincipalName dari SRV_CALL yang diteruskan oleh driver DFS.