RxForceFinalizeAllVNetRoots function (rxprocs.h)

Article
02/22/2024

RxForceFinalizeAllVNetRoots force finalizes all the V_NET_ROOT structures associated with a given NET_ROOT structure. The caller must have an exclusive lock on the netname table associated with the device object.

Syntax

void RxForceFinalizeAllVNetRoots(
  PNET_ROOT NetRoot
);

Parameters

NetRoot

A pointer to the NET_ROOT structure.

Return value

None

Remarks

The RxForceFinalizeAllVNetRoots routine is not called internally by RDBSS. RxForceFinalizeAllVNetRoots is normally called by network mini-redirector drivers directly. If a network mini-redirector implements client-side caching, the RxForceFinalizeAllVNetRoots routine could be used to close all open files for client-side caching. Forcing a close on all the V_NET_ROOT structures is equivalent to a WNetCancelConnection call from user mode on a share with forced close of all files.

Before calling RxForceFinalizeAllVNetRoots, a lock on the netname table associated with the device object must be acquired in exclusive mode.

RxForceFinalizeAllVNetRoots calls RxFinalizeVNetRoot to finalize each V_NET_ROOT associated with the NET_ROOT.

Requirements

Requirement	Value
Target Platform	Desktop
Header	rxprocs.h (include Rxprocs.h)
IRQL	<= APC_LEVEL