NetDfsAddRootTarget 函式 (lmdfs.h)

發行項
03/05/2024

建立網域型或獨立 DFS 命名空間，或將新的根目標新增至現有的網域型命名空間。

語法

NET_API_STATUS NET_API_FUNCTION NetDfsAddRootTarget(
  [in]           LPWSTR pDfsPath,
  [in, optional] LPWSTR pTargetPath,
  [in]           ULONG  MajorVersion,
  [in, optional] LPWSTR pComment,
  [in]           ULONG  Flags
);

參數

[in] pDfsPath

字串的指標，指定 DFS 命名空間的通用命名慣例 (UNC) 路徑。

若為獨立 DFS 命名空間，此字串的格式應如下：

\\ServerName\DfsName

其中 ServerName 是將裝載新 DFS 根目標的伺服器名稱， 而 DfsName 是 DFS 命名空間的名稱。

對於網域型 DFS 命名空間，此字串的格式應如下：

\\DomainName\DomDfsName

其中 DomainName 是裝載網域型 DFS 命名空間且 DomDfsName 是新網域或現有網域型 DFS 命名空間的名稱。基於相容性考慮， DomDfsName 應該與將裝載新 DFS 根目標之伺服器上的共享資料夾名稱相同。

[in, optional] pTargetPath

Null 終止 Unicode 字串的指標，指定 pDfsPath 參數中所指定 DFS 命名空間之 DFS 根目標的 UNC 路徑。

若為獨立 DFS 命名空間，此參數必須為 NULL。如果是網域型 DFS 命名空間，字串的格式應如下：

\\ServerName\RootShare

其中 ServerName 是將裝載新 DFS 根目標的伺服器名稱，而 RootShare 是伺服器上的共享資料夾名稱。 RootShare 指定的共享必須已存在於將裝載新 DFS 根目標的伺服器上。此函式不會建立新的共用。

[in] MajorVersion

指定命名空間的 DFS 元數據版本。

注意此參數僅適用於建立新的命名空間時。

如果要建立獨立 DFS 命名空間，此參數必須設定為 1。

如果要建立網域型命名空間，應該設定此參數，如下所示：

將它設定為 1 以指定 Windows 2000 模式。
將它設定為 2 或更新版本，以指定 Windows Server 2008 模式。

如果將新的根目標新增至現有的網域型 DFS 命名空間，此參數必須設定為零。

[in, optional] pComment

Null 終止 Unicode 字串的指標，其中包含與 DFS 根目錄相關聯的批注。

[in] Flags

此參數是保留的，而且必須是零。

傳回值

如果函式成功，傳回值會 NERR_Success。

如果定義域不是指定 MajorVersion 的必要功能等級，則會 ERROR_DS_INCOMPATIBLE傳回值。此傳回值僅適用於網域根目錄和 MajorVersion 為 2。

如果函式失敗，則傳回值是系統錯誤碼。如需錯誤碼的清單，請參閱系統錯誤碼。

備註

呼叫端必須在 DFS 伺服器上具有系統管理員許可權。

若要判斷可在 MajorVersion 參數中指定的 DFS 元數據版本，請使用 NetDfsGetSupportedNamespaceVersion 函式。

下表根據所需的結果，顯示您應該指定的參數值。

pDfsPath 參數	pTargetPath 參數	MajorVersion 參數	結果
\\DomainName\DomDfsName	\\ServerName\RootShare	1	建立 Windows 2000 模式網域型 DFS 命名空間，或將新的根目標新增至現有的根目標。
\\DomainName\DomDfsName	\\ServerName\RootShare	2	建立 Windows Server 2008 模式網域型 DFS 命名空間，或將新的根目標新增至現有的根目標。
\\DomainName\DomDfsName	\\ServerName\RootShare	0	將新的根目標新增至現有的 Windows 2000 模式或 Windows Server 2008 模式網域型 DFS 命名空間。
\\ServerName\DfsName	NULL	必須是 1。	建立獨立 DFS 命名空間。

規格需求

需求	值
最低支援的用戶端	Windows Vista SP1
最低支援的伺服器	Windows Server 2008
目標平台	Windows
標頭	lmdfs.h (包括 LmDfs.h、Lm.h)
程式庫	Netapi32.lib
Dll	Netapi32.dll