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,設定為值。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | fcb.h (包括 Rxcontx.h、Mrxfcb.h、Fcb.h) |
IRQL | <= APC_LEVEL |