RxCreateNetRoot 函式（fcb.h）

發行項
02/06/2025

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

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

NET_ROOT旗標分成兩個群組、網路迷你重新導向器可看見的旗標，以及網路迷你重新導向器看不到的旗標。可見的旗標是旗標成員NET_ROOT的下層 16 位。此例程不會檢查或測試要設定哪些旗標。

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