PMRX_SRVCALL_WINNER_NOTIFY Rückruffunktion (mrx.h)

Artikel
02/07/2025

Die MRxSrvCallWinnerNotify Routine wird von RDBSS- aufgerufen, um einen Netzwerk-Miniumleitungsmodul zu benachrichtigen, dass er ausgewählt wurde, wenn mehrere Umleitungen die Anforderung erfüllen konnten.

Syntax

PMRX_SRVCALL_WINNER_NOTIFY PmrxSrvcallWinnerNotify;

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

Parameter

SrvCall

[in, out] Ein Zeiger auf eine SRV_CALL Struktur, die vom Netzwerkminiumleitungsmodul erstellt wird.

ThisMinirdrIsTheWinner

[in] Ein boolescher Wert, der angibt, dass dieser Netzwerkminiumleitungsmodul ausgewählt wurde.

RecommunicateContext

[in/out] Zeiger auf den netzwerk mini-redirector-bereitgestellten Wert in PMRX_CREATE_SRVCALL.

Rückgabewert

MRxSmbSrvCallWinnerNotify gibt STATUS_SUCCESS zurück.

Bemerkungen

MRxSrvCallWinnerNotify wurde ursprünglich von RDBSS aufgerufen, um einen Netzwerk-Miniumleitungsmodul zu benachrichtigen, dass er ausgewählt wurde, wenn mehrere Umleitungen die Anforderung erfüllen konnten. Der ausgewählte Netzwerk-Miniumleitungsmodul wird erwartet, dass die SRV_CALL Struktur erstellt und eine Verbindung mit dem Server hergestellt wird.

Der Netzwerkminiumleitungsmodul sollte den Kontext für die SRV_CALL-Struktur abschließen. Wenn der Netzwerkminiumleitungs-Miniumleitung namen für NET_ROOT Strukturen und Dateinamen unterstützt, sollte das SRV_CALL Flags-Element Member die Bits für SRVCALL_FLAG_CASE_INSENSITIVE_NETROOTS und SRVCALL_FLAG_CASE_INSENSITIVE_FILENAMES festlegen.

Bei der aktuellen Implementierung von RDBSS verfügt jeder Netzwerkminiumleitung über eine eigene Kopie von RDBSS, sodass es keine konkurrierenden Netzwerkumleitungen auf der RDBSS-Ebene gibt. Alle Netzwerkminiumleitungen empfangen einen Aufruf von MRxSrvCallWinnerNotify mit dem ThisMinirdrIsTheWinner Parameter, der auf TRUE festgelegt ist, nachdem ein Aufruf von MRxCreateSrvCall empfangen wurde, um die SRV_CALL Struktur zu erstellen.

Wenn mehrere Umleitungen für die Behandlung desselben UNC-Namespace installiert werden, wird der Umleitungsanbieter für den Dienst einer Anforderung von mehreren UNC-Anbietern (MUP) basierend auf der Reihenfolge der in der Registrierung angegebenen Umleitungsmodule ausgewählt.