Edit

Share via


RxForceFinalizeAllVNetRoots function (rxprocs.h)

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

See also

RxCreateNetFcb

RxCreateNetFobx

RxCreateNetRoot

RxCreateSrvCall

RxCreateSrvOpen

RxCreateVNetRoot

RxDereference

RxFinalizeConnection

RxFinalizeNetFcb

RxFinalizeNetFobx

RxFinalizeNetRoot

RxFinalizeSrvCall

RxFinalizeSrvOpen

RxFinalizeVNetRoot

RxFinishFcbInitialization

RxReference

RxSetSrvCallDomainName

RxpDereferenceNetFcb

RxpReferenceNetFcb

The NET_ROOT Structure