RxFinalizeNetRoot 函式 (fcb.h)

RxFinalizeNetRoot 會完成指定的NET_ROOT結構。 呼叫端必須在與裝置對象相關聯的 netname 數據表上具有獨佔鎖定。

語法

BOOLEAN RxFinalizeNetRoot(
  [out] OUT PNET_ROOT ThisNetRoot,
  [in]  IN BOOLEAN    RecursiveFinalize,
  [in]  IN BOOLEAN    ForceFinalize
);

參數

[out] ThisNetRoot

要完成之NET_ROOT結構的指標。

[in] RecursiveFinalize

值,指出是否應該以遞歸方式完成最終處理。

[in] ForceFinalize

值,指出不論參考計數為何,是否應該強制完成。

如果 ForceFinalizeFALSE,則 ThisNetRoot 所指向NET_ROOT結構之 NodeReferenceCount 成員必須為 1,才能完成NET_ROOT。

傳回值

RxFinalizeNetRoot 會在成功時傳回 TRUE,如果未發生最終處理:如果NET_ROOT的完成已在處理中,RxFinalizeNetRoot 會傳回 FALSE

備註

網路迷你重新導向器驅動程式通常不會直接呼叫 RxFinalizeNetRoot 例程。 當NET_ROOT上的參考計數遞減為 1 時,RDBSS 會在內部呼叫此例程。

在呼叫 RxFinalizeNetRoot 之前,必須以獨佔模式取得與裝置對象相關聯的 netname 數據表鎖定。

如果 RecursiveFinalize 參數為 TRUE則 RxFinalizeNetRoot 將會清除與此NET_ROOT相關聯的任何孤立 FCB 結構。 這些 ophaned FCB 是 FcbState 成員已設定FCB_STATE_ORPHANED旗標的結構。

規格需求

需求
目標平台 桌面
標頭 fcb.h (包括 Fcb.h、Mrxfcb.h)
IRQL <= APC_LEVEL

另請參閱

RxCreateNetFcb

RxCreateNetFobx

RxCreateNetRoot

RxCreateSrvCall

RxCreateSrvOpen

RxCreateVNetRoot

RxDereference

RxFinalizeConnection

RxFinalizeNetFcb

RxFinalizeNetFobx

RxFinalizeSrvCall

RxFinalizeSrvOpen

RxFinalizeVNetRoot

RxFinishFcbInitialization

RxForceFinalizeAllVNetRoots

RxReference

RxSetSrvCallDomainName

RxpDereferenceNetFcb

RxpReferenceNetFcb

NET_ROOT 結構