Функция 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.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | fcb.h (включает Rxcontx.h, Mrxfcb.h, Fcb.h) |
| IRQL | <= APC_LEVEL |