PMRX_SRVCALL_WINNER_NOTIFY回调函数（mrx.h）

项目
02/07/2025

RDBSS 调用 MRxSrvCallWinnerNotify 例程，以通知网络微型重定向程序，当多个重定向程序可以满足请求时选择它。

语法

PMRX_SRVCALL_WINNER_NOTIFY PmrxSrvcallWinnerNotify;

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

参数

SrvCall

[in， out]指向由网络微型重定向程序创建的SRV_CALL结构的指针。

ThisMinirdrIsTheWinner

[in]一个布尔值，指示已选择此网络微型重定向程序。

RecommunicateContext

[in/out]指向 PMRX_CREATE_SRVCALL中网络微型重定向程序提供的值的指针。

返回值

MRxSmbSrvCallWinnerNotify 返回成功STATUS_SUCCESS。

言论

MRxSrvCallWinnerNotify 最初设计为 RDBSS 调用，以通知网络微型重定向程序在多个重定向程序满足请求时选择它。所选的网络微型重定向程序应创建SRV_CALL结构，并与服务器建立连接。

网络微型重定向程序应完成SRV_CALL结构的上下文。如果网络微型重定向程序支持NET_ROOT结构和文件名不区分大小写的名称，则SRV_CALL 标志成员应为SRVCALL_FLAG_CASE_INSENSITIVE_NETROOTS和SRVCALL_FLAG_CASE_INSENSITIVE_FILENAMES设置位。

在 RDBSS 的当前实现下，每个网络微型重定向程序都有自己的 RDBSS 副本，因此 RDBSS 层没有竞争的网络重定向程序。所有网络微型重定向程序都将收到调用 MRxSrvCallWinnerNotify，ThisMinirdrIsTheWinner 参数设置为 TRUE 后，收到调用 MRxCreateSrvCall 以创建SRV_CALL结构。

安装多个重定向程序以处理同一 UNC 命名空间时，会根据注册表中指定的重定向程序顺序，由多个 UNC 提供程序（MUP）选择请求的重定向程序。