RxForceFinalizeAllVNetRoots 関数 (rxprocs.h)

[アーティクル]
08/07/2023

RxForceFinalizeAllVNetRoots は、 特定のNET_ROOT構造体に関連付けられているすべてのV_NET_ROOT構造体を強制終了します。呼び出し元には、デバイスオブジェクトに関連付けられている netname テーブルに対する排他ロックが必要です。

構文

void RxForceFinalizeAllVNetRoots(
  PNET_ROOT NetRoot
);

パラメーター

NetRoot

NET_ROOT構造体へのポインター。

戻り値

なし

解説

RxForceFinalizeAllVNetRoots ルーチンは、RDBSS によって内部的に呼び出されません。 RxForceFinalizeAllVNetRoots は通常、ネットワークミニリダイレクタードライバーによって直接呼び出されます。ネットワークミニリダイレクターでクライアント側キャッシュが実装されている場合は、 RxForceFinalizeAllVNetRoots ルーチンを使用して、クライアント側キャッシュ用に開いているすべてのファイルを閉じる可能性があります。すべてのV_NET_ROOT構造体を強制的に閉じるのは、すべてのファイルを強制的に閉じる共有上のユーザーモードからの WNetCancelConnection 呼び出しと同じです。

RxForceFinalizeAllVNetRoots を呼び出す前に、デバイスオブジェクトに関連付けられている netname テーブルのロックを排他モードで取得する必要があります。

RxForceFinalizeAllVNetRoots はRxFinalizeVNetRoot を呼び出して、NET_ROOTに関連付けられている各V_NET_ROOTを最終処理します。