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 将尝试使用分配为关联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
  • 标志 成员根据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