共用方式為


RxCreateNetFobx 函式 (fcb.h)

RxCreateNetFobx 配置、初始化和插入新的檔案物件延伸模組 (FOBX) 結構到記憶體內部數據結構中,供開啟此 FOBX 的 FCB。

語法

PMRX_FOBX RxCreateNetFobx(
  [out] OUT PRX_CONTEXT  RxContext,
  [in]  IN PMRX_SRV_OPEN MrxSrvOpen
);

參數

[out] RxContext

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

[in] MrxSrvOpen

相關聯SRV_OPEN結構的指標。

傳回值

RxCreateNetFobx 會在成功時傳回新配置的 FOBX 數據結構的指標,或失敗時 NULL 指標。

言論

網路迷你重新導向器應該呼叫 RxCreateNetFobx,以在成功的建立作業結束時建立 FOBX。

在呼叫 RxCreateNetFobx之前,必須以獨佔模式取得與 FOBX 結構相關聯的 FCB。

RxCreateNetFobx 會嘗試並使用配置為相關聯 FCB 結構的 FOBX,如果有的話。 如果無法使用使用 FCB 配置的 FOBX,RxCreateNetFobx 會嘗試使用設定為相關聯SRV_OPEN結構的 FOBX。 在這些情況下,RxCreateNetFobx 只需要初始化現有的 FOBX 結構,就不需要記憶體配置。 如果相關聯 FCB 和 SRV_OPEN 結構上的 FOBX 結構都無法使用,RxCreateNetFobx 將會配置新的 FOBX 結構。

如果相關聯的FCB是分頁檔案,RxCreateNetFobx 在建立新的FOBX數據結構時配置非分頁集區內存。 如果相關聯的FCB不是分頁檔案,RxCreateNetFobx 在建立新的FOBX數據結構時配置分頁集區內存。

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

成功時,會設定FOBX結構中的下列FOBX成員:

  • NodeReference 成員設為 1。
  • FobxSerialNumber 成員設為 0。
  • SrvOpen 成員會設定為相關聯的SRV_OPEN結構。
  • fOpenCountDecremented 成員會設定為 FALSE
  • Flags 成員會根據RX_CONTEXT的參數以及是否需要配置新的 FOBX 來設定值。
成功時,會遞增SRV_OPEN結構的參考計數,且相關聯V_NET_ROOT結構上的 NumberOfFobxs 成員遞增。

要求

要求 價值
目標平臺 桌面
標頭 fcb.h (包括 Rxcontx.h、Mrxfcb.h、Fcb.h)
IRQL <= APC_LEVEL

另請參閱

RX_CONTEXT

RxCreateNetFcb

RxCreateNetRoot

RxCreateSrvCall

RxCreateSrvOpen

RxCreateVNetRoot

RxDereference

RxFinalizeConnection

RxFinalizeNetFcb

RxFinalizeNetFobx

RxFinalizeNetRoot

RxFinalizeSrvCall

RxFinalizeSrvOpen

RxFinalizeVNetRoot

RxFinishFcbInitialization

RxForceFinalizeAllVNetRoots

RxReference

RxSetSrvCallDomainName

RxpDereferenceNetFcb

RxpReferenceNetFcb