RxCreateNetRoot 函式 (fcb.h)

發行項
02/29/2024

RxCreateNetRoot 會配置並初始化NET_ROOT結構，並將名稱插入相關聯裝置物件的 net name 數據表中。

語法

PNET_ROOT RxCreateNetRoot(
  [in]           IN PSRV_CALL         SrvCall,
  [in]           IN PUNICODE_STRING   Name,
  [in]           IN ULONG             NetRootFlags,
  [in, optional] IN PRX_CONNECTION_ID RxConnectionId
);

參數

[in] SrvCall

相關聯SRV_CALL結構的指標。

[in] Name

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

[in] NetRootFlags

要設定NET_ROOT旗 標成員的值 ，用來表示NET_ROOT結構的狀態。

[in, optional] RxConnectionId

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

傳回值

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

備註

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

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

NET_ROOT旗標分成兩個群組，這些群組可供網路迷你重新導向器看見，以及網路迷你重新導向器看不到的群組。可見的元素是NET_ROOT之 Flags 成員的較低 16 位。此例程不會檢查或測試正在設定的旗標。

成功時，SRV_CALL 結構的參考計數會遞增。