PMRX_SRVCALL_WINNER_NOTIFY função de retorno de chamada (mrx.h)

Artigo
02/29/2024

A rotina MRxSrvCallWinnerNotify é chamada pelo RDBSS para notificar um minidiretório de rede de que ela foi escolhida quando vários redirecionadores poderiam atender à solicitação.

Sintaxe

PMRX_SRVCALL_WINNER_NOTIFY PmrxSrvcallWinnerNotify;

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

Parâmetros

SrvCall

[in, out] Um ponteiro para uma estrutura SRV_CALL criada pelo minidiretório de rede.

ThisMinirdrIsTheWinner

[in] Um valor booliano que indica que esse minidiretório de rede foi escolhido.

RecommunicateContext

[entrada/saída] Ponteiro para o valor fornecido pelo minidiretório de rede em PMRX_CREATE_SRVCALL.

Retornar valor

MRxSmbSrvCallWinnerNotify retorna STATUS_SUCCESS em caso de êxito.

Comentários

MRxSrvCallWinnerNotify foi originalmente projetado para ser chamado pelo RDBSS para notificar um minidiretório de rede de que ele foi escolhido quando vários redirecionadores poderiam atender à solicitação. Espera-se que o minidiretor de rede escolhido crie a estrutura SRV_CALL e estabeleça uma conexão com o servidor.

O minidiretório de rede deve concluir o contexto da estrutura SRV_CALL. Se o minidiretório de rede der suporte a nomes que não diferenciam maiúsculas de minúsculas para estruturas NET_ROOT e nomes de arquivo, o membro sinalizadores de SRV_CALL deverá definir os bits para SRVCALL_FLAG_CASE_INSENSITIVE_NETROOTS e SRVCALL_FLAG_CASE_INSENSITIVE_FILENAMES.

Na implementação atual do RDBSS, cada minidiretório de rede tem sua própria cópia do RDBSS, portanto, não há redirecionadores de rede concorrentes na camada RDBSS. Todos os minidiretórios de rede receberão uma chamada para MRxSrvCallWinnerNotify com o parâmetro ThisMinirdrIsTheWinner definido como TRUE depois de receber uma chamada para MRxCreateSrvCall para criar a estrutura SRV_CALL.

Quando vários redirecionadores são instalados para lidar com o mesmo namespace UNC, o redirecionador para atender a uma solicitação é escolhido por vários provedores UNC (MUP) com base na ordem dos redirecionadores especificados no registro.