PMRX_SRVCALL_WINNER_NOTIFY回调函数 (mrx.h)

项目
02/26/2024

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 Flags 成员应为SRVCALL_FLAG_CASE_INSENSITIVE_NETROOTS和SRVCALL_FLAG_CASE_INSENSITIVE_FILENAMES设置位。

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

安装多个重定向程序来处理同一 UNC 命名空间时，多个 UNC 提供程序 (MUP) 根据注册表中指定的重定向程序的顺序选择为请求提供服务的重定向程序。