Функция RxCreateVNetRoot (fcb.h)
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и флаг и.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | fcb.h (include Rxcontx.h, Mrxfcb.h, Prefix.h, Struchdr.h, Fcb.h) |
| IRQL | <= APC_LEVEL |