PMRX_SRVCALL_WINNER_NOTIFY fonction de rappel (mrx.h)

Article
07/02/2025

La routine MRxSrvCallWinnerNotify est appelée par RDBSS pour avertir un mini-redirecteur réseau qu’il a été choisi lorsque plusieurs redirecteurs peuvent répondre à la demande.

Syntaxe

PMRX_SRVCALL_WINNER_NOTIFY PmrxSrvcallWinnerNotify;

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

Paramètres

SrvCall

[in, out] Pointeur vers une structure SRV_CALL créée par le mini-redirecteur réseau.

ThisMinirdrIsTheWinner

[in] Valeur booléenne qui indique que ce mini-redirecteur réseau a été choisi.

RecommunicateContext

[in/out] Pointeur vers la valeur fournie par le mini-redirecteur réseau dans PMRX_CREATE_SRVCALL.

Valeur de retour

MRxSmbSrvCallWinnerNotify retourne STATUS_SUCCESS en cas de réussite.

Remarques

MRxSrvCallWinnerNotify a été initialement conçu pour être appelé par RDBSS pour notifier un mini-redirecteur réseau qu’il a été choisi lorsque plusieurs redirecteurs pouvaient répondre à la demande. Le mini-redirecteur réseau choisi est censé créer la structure de SRV_CALL et établir une connexion avec le serveur.

Le mini-redirecteur réseau doit terminer le contexte de la structure SRV_CALL. Si le mini-redirecteur réseau prend en charge les noms non sensibles à la casse pour les structures NET_ROOT et pour les noms de fichiers, les indicateurs de SRV_CALL membre doivent définir les bits pour SRVCALL_FLAG_CASE_INSENSITIVE_NETROOTS et SRVCALL_FLAG_CASE_INSENSITIVE_FILENAMES.

Dans le cadre de l’implémentation actuelle de RDBSS, chaque mini-redirecteur réseau a sa propre copie de RDBSS. Il n’y a donc pas de redirecteurs réseau concurrents au niveau de la couche RDBSS. Tous les mini-redirecteurs réseau recevront un appel à MRxSrvCallWinnerNotify avec le paramètre ThisMinirdrIsTheWinner défini sur TRUE après avoir reçu un appel à MRxCreateSrvCall pour créer la structure SRV_CALL.

Lorsque plusieurs redirecteurs sont installés pour gérer le même espace de noms UNC, le redirecteur vers le service d’une requête est choisi par plusieurs fournisseurs UNC (MUP) en fonction de l’ordre des redirecteurs spécifiés dans le Registre.