RxpDereferenceNetFcb 函式 (fcb.h)

發行項
02/26/2024

RxpDereferenceNetFcb 會遞減 FCB 結構的參考計數。

語法

LONG RxpDereferenceNetFcb(
  PFCB Fcb
);

參數

Fcb

要取值之FCB結構的指標。

傳回值

RxpDereferenceNetFcb 會在取值之後傳回最終參考計數。

備註

由於FCB中的內嵌資源，參考和取值 FDB 與其他數據結構的參考和取值不同。這表示呼叫端需要FCB狀態的相關信息， (它是否已完成 ) 。若要完成FCB，必須保留兩個鎖定，NET_ROOT名稱數據表鎖定以及FCB資源。這些考慮會導致取值FCB的不同方法。因此， RxpDereferenceNetFcb 不會嘗試完成FCB。

在 fcb.h 中定義許多宏以進行偵錯，這是呼叫此例程的慣用方式。這些宏提供 RxpReferenceNetFcb 或 RxpDereferenceNetFcb 例程的包裝函式，用於 FCB 結構上的檔案結構管理作業。 RxDereferenceNetFcb 宏是呼叫此例程的慣用方式。此宏會先呼叫 RxpTrackDereference 例程，以在呼叫 RxpDereferenceNetFcb 例程之前記錄要求的診斷資訊。

在已檢查的組建上，如果結構的節點類型不是FCB或最終參考計數小於 0，RxpDereferenceNetFcb 會導致系統 ASSERT。