NetDfsAddFtRoot 函式 (lmdfs.h)
建立新的網域型分散式檔案系統 (DFS) 命名空間。 如果命名空間已經存在,函式會將指定的根目標加入其中。
語法
NET_API_STATUS NET_API_FUNCTION NetDfsAddFtRoot(
[in] LPWSTR ServerName,
[in] LPWSTR RootShare,
[in] LPWSTR FtDfsName,
[in, optional] LPWSTR Comment,
[in] DWORD Flags
);
參數
[in] ServerName
字串的指標,指定將裝載新 DFS 根目標的伺服器名稱。 這個值不能是 IP 位址。 此為必要參數。
[in] RootShare
字串的指標,指定將裝載新 DFS 根目標的伺服器上共用資料夾的名稱。 此為必要參數。
[in] FtDfsName
指定新或現有網域型 DFS 命名空間名稱的字串指標。 此為必要參數。 基於相容性考慮,它應該指定與 RootShare 參數相同的字串。
[in, optional] Comment
字串的指標,其中包含與 DFS 命名空間相關聯的選擇性批註。
[in] Flags
此參數是保留的,而且必須是零。
傳回值
如果函式成功,傳回值 會NERR_Success。
如果函式失敗,則傳回值是系統錯誤碼。 如需錯誤碼的清單,請參閱 系統錯誤碼。
備註
RootShare參數指定的共用必須已存在於將裝載新 DFS 根目標的伺服器上。 此函式不會建立新的共用。
呼叫端必須具有更新目錄服務中 DFS 容器的許可權,而且必須在 DFS 主機上具有系統管理員許可權, (根) 伺服器。
需求
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | lmdfs.h (包括 LmDfs.h、Lm.h) |
程式庫 | Netapi32.lib |
Dll | Netapi32.dll |