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,如果未進行最終化,則傳回 FALSE FALSE:如果NET_ROOT已完成,RxFinalizeNetRoot 會傳回 FALSE 。
言論
RxFinalizeNetRoot 例程通常不會由網路迷你重新導向器驅動程式直接呼叫。 當NET_ROOT上的參考計數遞減為 1 時,RDBSS 會在內部呼叫此例程。
呼叫 RxFinalizeNetRoot之前,必須以獨佔模式取得與裝置對象相關聯的 netname 數據表鎖定。
如果 RecursiveFinalize 參數 TRUE,則 RxFinalizeNetRoot 會清除與此NET_ROOT相關聯的任何孤立 FCB 結構。 這些孤立的FCB是 FcbState 成員已設定FCB_STATE_ORPHANED旗標的結構。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | fcb.h (包括 Fcb.h、Mrxfcb.h) |
IRQL | <= APC_LEVEL |