Функция RxFinalizeNetRoot (fcb.h)

Статья
02/26/2024

RxFinalizeNetRoot завершает указанную структуру NET_ROOT. Вызывающий объект должен иметь монопольную блокировку в таблице netname, связанной с объектом устройства.

Синтаксис

BOOLEAN RxFinalizeNetRoot(
  [out] OUT PNET_ROOT ThisNetRoot,
  [in]  IN BOOLEAN    RecursiveFinalize,
  [in]  IN BOOLEAN    ForceFinalize
);

Параметры

[out] ThisNetRoot

Указатель на структуру NET_ROOT для завершения.

[in] RecursiveFinalize

Значение, указывающее, следует ли выполнять завершение рекурсивно.

[in] ForceFinalize

Значение, указывающее, следует ли принудительно завершать, независимо от количества ссылок.

Если forceFinalize имеет значение FALSE, то для завершения NET_ROOT должен быть элемент NodeReferenceCount структуры NET_ROOT, на которую указывает ThisNetRoot .

Возвращаемое значение

RxFinalizeNetRoot возвращает значение TRUE при успешном выполнении или FALSE , если завершение не произошло. Если завершение NET_ROOT уже выполняется, RxFinalizeNetRoot возвращает значение FALSE.

Подпрограмма RxFinalizeNetRoot обычно не вызывается драйверами мини-перенаправления сети напрямую. RDBSS вызывает эту подпрограмму внутренним образом, когда количество ссылок на NET_ROOT уменьшается до 1.

Перед вызовом RxFinalizeNetRoot блокировка таблицы netname, связанной с объектом устройства, должна быть получена в монопольном режиме.

Если параметр RecursiveFinalize имеет значение TRUE, RxFinalizeNetRoot очистит все потерянные структуры FCB, связанные с этим NET_ROOT. Эти потерянные FBS — это структуры, в которых член FcbState имеет флаг FCB_STATE_ORPHANED.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	fcb.h (включая Fcb.h, Mrxfcb.h)
IRQL	<= APC_LEVEL