PMRX_SRVCALL_WINNER_NOTIFY funzione di callback (mrx.h)

Articolo
02/29/2024

La routine MRxSrvCallWinnerNotify viene chiamata da RDBSS per notificare a un mini redirector di rete che è stato scelto quando più redirector potrebbero soddisfare la richiesta.

Sintassi

PMRX_SRVCALL_WINNER_NOTIFY PmrxSrvcallWinnerNotify;

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

Parametri

SrvCall

[in, out] Puntatore a una struttura SRV_CALL creata dal mini redirector di rete.

ThisMinirdrIsTheWinner

[in] Valore booleano che indica che è stato scelto questo mini-reindirizzamento di rete.

RecommunicateContext

[in/out] Puntatore al valore fornito dal mini redirector di rete in PMRX_CREATE_SRVCALL.

Valore restituito

MRxSmbSrvCallWinnerNotify restituisce STATUS_SUCCESS in caso di esito positivo.

Commenti

MRxSrvCallWinnerNotify è stato originariamente progettato per essere chiamato da RDBSS per notificare a un mini redirector di rete che è stato scelto quando più redirector potrebbero soddisfare la richiesta. Si prevede che il mini-reindirizzamento di rete scelto crei la struttura SRV_CALL e stabilisca una connessione con il server.

Il mini-redirector di rete deve completare il contesto per la struttura SRV_CALL. Se il mini-redirector di rete supporta nomi senza distinzione tra maiuscole e minuscole per le strutture NET_ROOT e per i nomi file, il membro SRV_CALL Flags deve impostare i bit per SRVCALL_FLAG_CASE_INSENSITIVE_NETROOTS e SRVCALL_FLAG_CASE_INSENSITIVE_FILENAMES.

Nell'implementazione corrente di SERVIZI Desktop remoto, ogni mini-reindirizzamento di rete dispone di una propria copia di SERVIZI Desktop remoto, quindi non sono presenti reindirizzamenti di rete concorrenti a livello di SERVIZI Desktop remoto. Tutti i mini-reindirizzamenti di rete riceveranno una chiamata a MRxSrvCallWinnerNotify con il parametro ThisMinirdrIsTheWinner impostato su TRUE dopo aver ricevuto una chiamata a MRxCreateSrvCall per creare la struttura SRV_CALL.

Quando vengono installati più redirector per la gestione dello stesso spazio dei nomi UNC, il redirector per gestire una richiesta viene scelto da più provider UNC (MUP) in base all'ordine dei redirector specificati nel Registro di sistema.