PMRX_SRVCALL_WINNER_NOTIFY fonction de rappel (mrx.h)

Article
02/26/2024

La routine MRxSrvCallWinnerNotify est appelée par RDBSS pour informer 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

[entrée/sortie] Pointeur vers la valeur fournie par le mini-redirecteur réseau dans PMRX_CREATE_SRVCALL.

Valeur retournée

MRxSmbSrvCallWinnerNotify retourne STATUS_SUCCESS en cas de réussite.

Remarques

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

Le mini-redirecteur réseau doit compléter le contexte de la structure SRV_CALL. Si le mini-redirecteur réseau prend en charge les noms qui ne respectent pas la casse pour les structures NET_ROOT et les noms de fichiers, le membre SRV_CALL Flags doit 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 pour traiter une demande est choisi par plusieurs fournisseurs UNC (MUP) en fonction de l’ordre des redirecteurs spécifiés dans le Registre.