PMRX_SRVCALL_WINNER_NOTIFY función de devolución de llamada (mrx.h)

Artículo
02/29/2024

RDBSS llama a la rutina MRxSrvCallWinnerNotify para notificar a un minidirector de red que se eligió cuando varios redireccionadores podrían cumplir la solicitud.

Sintaxis

PMRX_SRVCALL_WINNER_NOTIFY PmrxSrvcallWinnerNotify;

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

Parámetros

SrvCall

[dentro, fuera] Puntero a una estructura de SRV_CALL creada por el minidirector de red.

ThisMinirdrIsTheWinner

[in] Valor booleano que indica que se eligió este minidirector de red.

RecommunicateContext

[in/out] Puntero al valor proporcionado por minidirector de red en PMRX_CREATE_SRVCALL.

Valor devuelto

MRxSmbSrvCallWinnerNotify devuelve STATUS_SUCCESS de éxito.

Comentarios

MRxSrvCallWinnerNotify se diseñó originalmente para ser llamado por RDBSS para notificar a un minidirector de red que se eligió cuando varios redireccionadores podían cumplir la solicitud. Se espera que el minidirector de red elegido cree la estructura de SRV_CALL y establezca una conexión con el servidor.

El minidirector de red debe completar el contexto de la estructura de SRV_CALL. Si el minidirector de red admite nombres que no distinguen mayúsculas de minúsculas para estructuras de NET_ROOT y para nombres de archivo, el miembro SRV_CALL Flags debe establecer los bits para SRVCALL_FLAG_CASE_INSENSITIVE_NETROOTS y SRVCALL_FLAG_CASE_INSENSITIVE_FILENAMES.

En la implementación actual de RDBSS, cada minidirector de red tiene su propia copia de RDBSS, por lo que no hay redireccionadores de red competidores en la capa RDBSS. Todos los miniireccionadores de red recibirán una llamada a MRxSrvCallWinnerNotify con el parámetro ThisMinirdrIsTheWinner establecido en TRUE después de recibir una llamada a MRxCreateSrvCall para crear la estructura de SRV_CALL.

Cuando se instalan varios redireccionadores para controlar el mismo espacio de nombres UNC, el redirector para atender una solicitud se elige mediante varios proveedores UNC (MUP) en función del orden de los redireccionadores especificados en el registro.