RxpDereferenceAndFinalizeNetFcb function (fcb.h)

Article
03/15/2022

RxpDereferenceAndFinalizeNetFcb decrements the reference count and finalizes an FCB structure.

Syntax

BOOLEAN RxpDereferenceAndFinalizeNetFcb(
       OUT PFCB       ThisFcb,
  [in] IN PRX_CONTEXT RxContext,
  [in] IN BOOLEAN     RecursiveFinalize,
  [in] IN BOOLEAN     ForceFinalize
);

Parameters

ThisFcb

A pointer to the FCB structure to be dereferenced and finalized.

[in] RxContext

A pointer to the RX_CONTEXT structure associated with the Fcb parameter.

[in] RecursiveFinalize

A parameter that indicates if this should be a recursive finalize operation.

[in] ForceFinalize

A parameter that indicates if this routine should force the Fcb parameter to be finalized.

Return value

RxpDereferenceAndFinalizeNetFcb returns TRUE if the FCB was finalized.

Remarks

The referencing and dereferencing of FCBs is different from those of the other data structures because of the embedded resource in the FCB. This implies that the caller requires information regarding the status of the FCB (whether it was finalized or not ).To finalize the FCB, two locks need to be held, the NET_ROOT name table lock as well as the FCB resource. RxpDereferenceAndFinalizeNetFcb acquires the additional lock if required to finalize the FCB.

On checked builds, RxpDereferenceAndFinalizeNetFcb causes the system to ASSERT if ForceFinalize is FALSE, if the node type for the structure is not an FCB, or if the FCB was acquired exclusive.

Requirements

Requirement	Value
Minimum supported client	The RxpDereferenceAndFinalizeNetFcb routine is only available on Windows Server 2003 Service Pack 1 (SP1) and later.
Target Platform	Desktop
Header	fcb.h (include Fcb.h)
IRQL	<= APC_LEVEL