RxFinalizeNetFobx function (fcb.h)

RxFinalizeNetFOBX finalizes the given FOBX structure. The caller must have an exclusive lock on the FCB associated with FOBX structure.

Syntax

BOOLEAN RxFinalizeNetFobx(
  [out] OUT PFOBX  ThisFobx,
  [in]  IN BOOLEAN RecursiveFinalize,
  [in]  IN BOOLEAN ForceFinalize
);

Parameters

[out] ThisFobx

A pointer to the FOBX structure to finalize.

[in] RecursiveFinalize

The value indicating whether the finalization should be done recursively. This parameter is not currently used.

[in] ForceFinalize

The value indicating whether the finalization should be forced, regardless of the reference count.

If ForceFinalize is FALSE, then the NodeReferenceCount member of the FOBX structure pointed to by ThisFobx must be 0 for the FOBX to be finalized.

Return value

RxFinalizeNetFOBX returns TRUE on success or FALSE if the finalization did not occur:

Remarks

The RxFinalizeNetFOBX routine is not normally called by network mini-redirector drivers directly. RDBSS calls this routine internally when an I/O request packet is received for IRP_MJ_CLOSE. This IRP is normally received by RDBSS in response to a user-mode application requesting a file close operation. It is also possible for another kernel driver to issue such an IRP.

Before calling RxFinalizeNetFOBX, a lock on the FCB structure must be acquired in exclusive mode.

The RxFinalizeNetFOBX routine will call the MRxDeallocateForFobx routine provided by the network mini-redirector to free the memory for the FOBX if the network mini-redirector supports this routine.

Requirements

Requirement Value
Target Platform Desktop
Header fcb.h (include Mrxfcb.h, Fcb.h)
IRQL <= APC_LEVEL

See also

RxCreateNetFcb

RxCreateNetFobx

RxCreateNetRoot

RxCreateSrvCall

RxCreateSrvOpen

RxCreateVNetRoot

RxDereference

RxFinalizeConnection

RxFinalizeNetFcb

RxFinalizeNetRoot

RxFinalizeSrvCall

RxFinalizeSrvOpen

RxFinalizeVNetRoot

RxFinishFcbInitialization

RxForceFinalizeAllVNetRoots

RxReference

RxSetSrvCallDomainName

RxpDereferenceNetFcb

RxpReferenceNetFcb

The FCB Structure

The FOBX Structure