NetDfsRemoveFtRoot 函式 (lmdfs.h)
從網域型分散式文件系統中移除指定的根目標, (DFS) 命名空間。 如果移除 DFS 命名空間的最後一個根目標,函式也會刪除 DFS 命名空間。 您可以刪除 DFS 命名空間,而不需要先刪除其中的所有連結。
語法
NET_API_STATUS NET_API_FUNCTION NetDfsRemoveFtRoot(
[in] LPWSTR ServerName,
[in] LPWSTR RootShare,
[in] LPWSTR FtDfsName,
DWORD Flags
);
參數
[in] ServerName
字串的指標,指定要移除之根目標的伺服器名稱。 伺服器必須裝載網域型 DFS 命名空間的根目錄。 此為必要參數。
[in] RootShare
字串的指標,指定要移除的 DFS 根目標共享名稱。 此為必要參數。
[in] FtDfsName
字串的指標,指定要從中移除根目標的網域型 DFS 命名空間名稱。 此為必要參數。 一般而言,它與 RootShare 參數相同。
Flags
此參數是保留的,而且必須是零。
傳回值
如果函式成功,傳回值 會NERR_Success。
如果函式失敗,則傳回值是系統錯誤碼。 如需錯誤碼的清單,請參閱 系統錯誤碼。
備註
根目標伺服器必須可供使用且可供存取;否則, 對 NetDfsRemoveFtRoot 函式的呼叫將會失敗。
呼叫端必須具有更新目錄服務中 DFS 容器的許可權,而且必須在 DFS 主機上具有系統管理員許可權, (根) 伺服器。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | lmdfs.h (包括 LmDfs.h、Lm.h) |
程式庫 | Netapi32.lib |
Dll | Netapi32.dll |