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