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

Статья
02/26/2024

RxCreateVNetRoot выделяет и инициализирует структуру NET_ROOT и вставляет имя в таблицу net name в связанном объекте устройства.

Синтаксис

PV_NET_ROOT RxCreateVNetRoot(
  [in] IN PRX_CONTEXT       RxContext,
  [in] IN PNET_ROOT         NetRoot,
  [in] IN PUNICODE_STRING   CanonicalName,
  [in] IN PUNICODE_STRING   LocalNetRootName,
  [in] IN PUNICODE_STRING   FilePath,
  [in] IN PRX_CONNECTION_ID RxConnectionId
);

Параметры

[in] RxContext

Указатель на RX_CONTEXT RDBSS, содержащий IRP, описывающий операцию создания.

[in] NetRoot

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

[in] CanonicalName

Указатель на каноническое имя, вставляемое в таблицу имен.

[in] LocalNetRootName

Указатель на имя локального NET_ROOT без имени префикса.

[in] FilePath

Указатель на путь к файлу. Этот параметр в настоящее время не используется и может иметь значение NULL.

[in] RxConnectionId

Указатель на идентификатор подключения, связанный с именем, вставляемым в таблицу имен префиксов. Этот параметр может иметь значение NULL , в этом случае идентификатор подключения не будет связан с именем, вставленным в таблицу имен.

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

RxCreateVNetRoot возвращает указатель на только что созданную V_NET_ROOT структуру данных об успешном выполнении или указатель NULL при сбое.

Подпрограмма RxCreateVNetRoot обычно не вызывается драйверами мини-перенаправления сети напрямую. RDBSS вызывает эту подпрограмму внутренне, когда пакет запроса ввода-вывода получен для IRP_MJ_CREATE и необходимо создать V_NET_ROOT. Этот IRP обычно получается RDBSS в ответ на запрос операции создания файла в общей сетевой папке в пользовательском режиме. Такой IRP также может выдать другой драйвер ядра.

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

RxCreateVNetRoot задает различные параметры контекста безопасности в структуре V_NET_ROOT на основе параметров из RX_CONTEXT. К этим параметрам относятся: LogonId, SessionId, pUserName, pUserDomainName, pPassword и Flags.

Требования

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