RxCreateNetFobx 函数 (fcb.h)

RxCreateNetFobx 为打开此 FOBX 的 FCB 分配、初始化和插入新的文件对象扩展名 (FOBX) 结构。

语法

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 将尝试使用分配的 FOBX 作为关联 FCB 结构的一部分(如果可用)。 如果随 FCB 一起分配的 FOBX 不可用,则 RxCreateNetFobx 将尝试使用分配的 FOBX 作为关联的SRV_OPEN结构的一部分(如果可用)。 在这两种情况下, 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
  • 根据RX_CONTEXT的参数以及是否需要分配新的 FOBX, 将 Flags 成员设置为一个值。
成功后,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