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
值，指出不論參考計數為何，是否應該強制完成。
如果 ForceFinalize 為 FALSE，則 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 結構。 這些孤立的 FCB是FcbState 成員已設定FCB_STATE_ORPHANED旗標的結構。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | 桌面 |
| 標頭 | fcb.h (包括 Fcb.h、Mrxfcb.h) |
| IRQL | <= APC_LEVEL |