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 设置为值。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | fcb.h (包括 Rxcontx.h、Mrxfcb.h、Fcb.h) |
IRQL | <= APC_LEVEL |