функция обратного вызова PMRX_SRVCALL_WINNER_NOTIFY (mrx.h)

Статья
10/13/2023

Подпрограмма MRxSrvCallWinnerNotify вызывается RDBSS для уведомления сетевого мини-перенаправителя о том, что он был выбран, когда несколько перенаправителей могут выполнить запрос.

Синтаксис

PMRX_SRVCALL_WINNER_NOTIFY PmrxSrvcallWinnerNotify;

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

Параметры

SrvCall

[вход, выход] Указатель на структуру SRV_CALL, созданную мини-перенаправлением сети.

ThisMinirdrIsTheWinner

[in] Логическое значение, указывающее, что выбран этот мини-перенаправление сети.

RecommunicateContext

[вход/выход] Указатель на значение, предоставленное мини-перенаправлением сети в 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) в зависимости от порядка перенаправлений, указанного в реестре.