PMRX_SRVCALL_WINNER_NOTIFY fungsi panggilan balik (mrx.h)

Artikel
02/26/2024

Rutinitas MRxSrvCallWinnerNotify dipanggil oleh RDBSS untuk memberi tahu pengalih mini jaringan bahwa itu dipilih ketika beberapa pengalihan dapat memenuhi permintaan.

Sintaks

PMRX_SRVCALL_WINNER_NOTIFY PmrxSrvcallWinnerNotify;

NTSTATUS PmrxSrvcallWinnerNotify(
  IN OUT PMRX_SRV_CALL SrvCall,
  IN BOOLEAN ThisMinirdrIsTheWinner,
  IN OUT PVOID RecommunicateContext
)
{...}

Parameter

SrvCall

[in, out] Penunjuk ke struktur SRV_CALL yang dibuat oleh pengalih mini jaringan.

ThisMinirdrIsTheWinner

[in] Nilai Boolean yang menunjukkan bahwa pengalihan mini jaringan ini dipilih.

RecommunicateContext

[masuk/keluar] Arahkan ke nilai yang disediakan pengalih mini jaringan dalam PMRX_CREATE_SRVCALL.

Nilai kembali

MRxSmbSrvCallWinnerNotify mengembalikan STATUS_SUCCESS pada keberhasilan.

Keterangan

MRxSrvCallWinnerNotify awalnya dirancang untuk dipanggil oleh RDBSS untuk memberi tahu pengalih mini jaringan bahwa itu dipilih ketika beberapa pengalihan dapat memenuhi permintaan. Pengalih mini jaringan yang dipilih diharapkan membuat struktur SRV_CALL dan membangun koneksi dengan server.

Pengalih mini jaringan harus menyelesaikan konteks untuk struktur SRV_CALL. Jika pengalih mini jaringan mendukung nama yang tidak peka huruf besar/kecil untuk struktur NET_ROOT dan untuk nama file, maka anggota Bendera SRV_CALL harus mengatur bit untuk SRVCALL_FLAG_CASE_INSENSITIVE_NETROOTS dan SRVCALL_FLAG_CASE_INSENSITIVE_FILENAMES.

Di bawah implementasi RDBSS saat ini, setiap pengalih mini jaringan memiliki salinan RDBSS sendiri, sehingga tidak ada pengalih jaringan yang bersaing di lapisan RDBSS. Semua pengalih mini jaringan akan menerima panggilan ke MRxSrvCallWinnerNotify dengan parameter ThisMinirdrIsTheWinner diatur ke TRUE setelah menerima panggilan ke MRxCreateSrvCall untuk membuat struktur SRV_CALL.

Ketika beberapa pengalihan diinstal untuk menangani namespace UNC yang sama, pengalih untuk melayani permintaan dipilih oleh beberapa penyedia UNC (MUP) berdasarkan urutan pengalihan yang ditentukan dalam registri.