PMRX_SRVCALL_WINNER_NOTIFY Rückruffunktion (mrx.h)

Artikel
10/13/2023

Die MRxSrvCallWinnerNotify-Routine wird von RDBSS aufgerufen, um eine Netzwerkminiumleitung darüber zu benachrichtigen, dass sie 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

[ein, aus] Ein Zeiger auf eine SRV_CALL-Struktur, die vom Netzwerkminiumleitungsor erstellt wird.

ThisMinirdrIsTheWinner

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

RecommunicateContext

[ein/aus] Zeiger auf den Vom Netzwerk bereitgestellten Mini-Redirector-Wert in PMRX_CREATE_SRVCALL.

Rückgabewert

MRxSmbSrvCallWinnerNotify gibt bei Erfolg STATUS_SUCCESS zurück.

Hinweise

MRxSrvCallWinnerNotify wurde ursprünglich für den Aufruf von RDBSS entwickelt, um einen Netzwerk-Mini-Redirector zu benachrichtigen, dass er ausgewählt wurde, wenn mehrere Umleitungen die Anforderung erfüllen konnten. Vom ausgewählten Netzwerkminiumleitungsor wird erwartet, dass er die SRV_CALL-Struktur erstellt und eine Verbindung mit dem Server herstellt.

Der Netzwerkminiumleitungsor sollte den Kontext für die SRV_CALL-Struktur vervollständigen. Wenn der Netzwerkminiumleitungsor namen unterstützt, bei NET_ROOT Strukturen und Dateinamen die Groß-/Kleinschreibung nicht beachtet wird, sollte der SRV_CALL Flags-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 Netzwerkminiumleitungsor über eine eigene Kopie von RDBSS, sodass es keine konkurrierenden Netzwerkumleitungen auf der RDBSS-Ebene gibt. Alle Netzwerkminiumleitungen erhalten einen Aufruf von MRxSrvCallWinnerNotify , wobei der ThisMinirdrIsTheWinner-Parameter auf TRUE festgelegt ist, nachdem sie einen Aufruf von MRxCreateSrvCall erhalten haben, um die SRV_CALL-Struktur zu erstellen.

Wenn mehrere Umleitungen für die Behandlung desselben UNC-Namespaces installiert werden, wird der Umleitungsor für die Verarbeitung einer Anforderung von mehreren UNC-Anbietern (MUP) basierend auf der Reihenfolge der In der Registrierung angegebenen Umleitungen ausgewählt.