RxCreateNetFcb 函式 (fcb.h)

發行項
02/26/2024

RxCreateNetFCB 會配置、初始化新的FCB結構，並將新的FCB結構插入記憶體內部數據結構，以取得開啟此FCB的V_NET_ROOT。配置的結構具有SRV_OPEN和FOBX結構的空間。

語法

PFCB RxCreateNetFcb(
  [in] IN PRX_CONTEXT     RxContext,
  [in] IN PIRP            Irp,
  [in] IN PV_NET_ROOT     VNetRoot,
  [in] IN PUNICODE_STRING Name
);

參數

[in] RxContext

描述建立作業之RX_CONTEXT結構的指標。

[in] Irp

這個 RX_CONTEXT 結構所封裝之 IRP 的指標。

[in] VNetRoot

開啟這個FCB之V_NET_ROOT結構的指標。

[in] Name

FCB 的名稱。 V_NET_ROOT可能包含要在此前面加上的名稱前置詞。

傳回值

RxCreateNetFCB 會在成功時傳回新配置的FCB數據結構的指標，或在失敗時傳回 NULL 指標。

備註

網路迷你重新導向器驅動程式通常不會直接呼叫 RxCreateNetFCB 例程。當收到IRP_MJ_CREATE的 I/O 要求封包，且需要建立 FCB 結構時，RDBSS 會在內部呼叫此例程。 RDBSS 通常會收到此 IRP，以回應要求網路共用上檔案建立作業的使用者模式應用程式。另一個核心驅動程式也可能發出這類 IRP。

如果要建立的FCB是分頁檔案， RxCreateNetFCB 會在建立新的FCB數據結構時配置非分頁集區內存，並在FCB的FcbState成員中設定下列旗標：

如果要建立的FCB不是分頁檔案， RxCreateNetFCB 會在建立新的FCB數據結構時配置分頁集區內存。

Windows 目前不允許在遠端電腦上有分頁檔案。

如果RX_CONTEXT中的 Create.Flags 成員已開啟RX_CONTEXT_CREATE_FLAG_ADDEDBACKSLASH旗標， 則 FCB 的 FcbState 成員已設定FCB_STATE_ADDEDBACKSLASH旗標。