RxFinalizeConnection 関数 (rxprocs.h)

[アーティクル]
10/14/2023

RxFinalizeConnection は、共有への接続を削除します。接続で開いているファイルは、指定された力のレベルに応じて閉じられます。ネットワークミニリダイレクターは、接続を強制的に閉じるオプションが指定されていない限り、パフォーマンス上の理由からトランスポート接続を開いたままにすることを選択する場合があります。

構文

NTSTATUS RxFinalizeConnection(
  IN OUT PNET_ROOT   NetRoot,
  IN OUT PV_NET_ROOT VNetRoot,
  IN LOGICAL         ForceFilesClosed
);

パラメーター

NetRoot

[入力、出力]最終処理されるNET_ROOT構造体へのポインター。

VNetRoot

最終処理されるV_NET_ROOT構造体へのポインター。

ForceFilesClosed

RxFinalizeConnection ルーチンの動作を制御するフラグ。フラグには、次のいずれかの値を指定できます。

True
False
0 xff

戻り値

RxFinalizeConnection は、成功した場合はSTATUS_SUCCESSを返し、失敗した場合は次のいずれかのエラーコードを返します。

リターンコード	説明
STATUS_CANCELLED	RX_CONTEXT構造体の Flags メンバーは、IRP が取り消されたことを示します。
STATUS_CONNECTION_IN_USE	接続は引き続き使用されています。
STATUS_FILES_OPEN	ファイルが開いていたため、リモート接続を削除しないでください。
STATUS_LOCK_NOT_GRANTED	関連付けられているに対する排他ロック

注釈

RxFinalizeConnection は通常、ユーザーモードからのカスタム IOCTL 要求の受信に応答して、ネットワークミニリダイレクタードライバーによって呼び出されます。たとえば、ユーザーはコマンドラインから "NET USE x: /d" を実行して共有を削除できます。この要求は、ネットワークミニリダイレクターによって提供されるネットワークプロバイダー DLL を介して、接続を削除するために RxFinalizeConnection ルーチンを呼び出すネットワークミニリダイレクターカーネルドライバーに送信されるカスタム IOCTL 要求にマップされます。

RxFinalizeConnection は、特定のV_NET_ROOT構造体に対するすべての未処理の要求を取り消します。これらのV_NET_ROOT構造は、開かれて操作されるファイルとは無関係に作成および削除されます。したがって、削除操作が試行されると、未処理のすべての要求が取り消される必要があります。