RxpDereferenceAndFinalizeNetFcb function (fcb.h)
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 |