Поделиться через


Функция 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 необходимо получить FCB, связанный со структурой FOBX, в монопольном режиме.

RxCreateNetFobx попытается использовать FOBX, выделенный как часть связанной структуры FCB, если она доступна. Если FOBX, выделенный с помощью FCB, недоступен, RxCreateNetFobx попытается использовать FOBX, выделенный как часть связанной структуры SRV_OPEN, если она доступна. В любом из этих случаев RxCreateNetFobx требуется только инициализировать существующую структуру FOBX. Выделение памяти не требуется. Если обе структуры FOBX в связанной структуре FCB и SRV_OPEN недоступны, 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 и увеличивается член NumberOfFobxs в связанной V_NET_ROOT структуре.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть 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