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

[入力]このネットワークミニリダイレクターが選択されたことを示すブール値。

RecommunicateContext

[入力/出力] 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構造体を作成した後、ThisMinirdrIsTheWinner パラメーターを TRUE に設定して MRxSrvCallWinnerNotify の呼び出しを受け取ります。

同じ UNC 名前空間を処理するために複数のリダイレクターがインストールされている場合、要求を処理するリダイレクターは、レジストリで指定されたリダイレクターの順序に基づいて、複数の UNC プロバイダー (MUP) によって選択されます。