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

RDBSS 的指標RX_CONTEXT包含描述建立作業的 IRP。

[in] NetRoot

相關聯NET_ROOT結構的指標。

[in] CanonicalName

要插入名稱數據表中標準名稱的指標。

[in] LocalNetRootName

沒有前置詞名稱之本機NET_ROOT名稱的指標。

[in] FilePath

檔案路徑名稱的指標。此參數目前未使用，而且可以是 NULL。

[in] RxConnectionId

要與前置詞名稱數據表中插入之名稱相關聯的連接標識符指標。這個參數可以是 NULL ，在此情況下，沒有任何連接標識元與名稱數據表中插入的名稱相關聯。

傳回值

RxCreateVNetRoot 會在成功時傳回新建立V_NET_ROOT數據結構的指標，或在失敗時傳回 NULL 指標。

備註

網路迷你重新導向器驅動程式通常不會直接呼叫 RxCreateVNetRoot 例程。當收到 I/O 要求封包以供IRP_MJ_CREATE，且需要建立V_NET_ROOT時，RDBSS 會在內部呼叫此例程。 RDBSS 通常會收到此 IRP，以回應要求網路共用上檔案建立作業的使用者模式應用程式。另一個核心驅動程式也可能發出這類 IRP。

在呼叫 RxCreateVNetRoot 之前，必須以獨佔模式取得 與 RxContext 參數裝置對象成員相關聯的名稱數據表鎖定。

RxCreateVNetRoot 會根據RX_CONTEXT的參數，在V_NET_ROOT結構上設定各種安全性內容參數。這些參數包括： LogonId、 SessionId、 pUserName、 pUserDomainName、 pPassword 和 Flags。