NetDfsRemoveFtRootForced 函式 (lmdfs.h)

從網域型分散式文件系統 (DFS) 命名空間中移除指定的根目標，即使根目標伺服器已離線也一樣。 如果要移除 DFS 命名空間的最後一個根目標，此函式也會刪除 DFS 命名空間。 您可以刪除 DFS 命名空間，而不需要先刪除其中的所有連結。

注意NetDfsRemoveFtRootForced 函式不會更新 DFS 根目標伺服器上的登錄。 如需詳細資訊，請參閱＜備註＞一節。

 

語法

NET_API_STATUS NET_API_FUNCTION NetDfsRemoveFtRootForced(
  [in] LPWSTR DomainName,
  [in] LPWSTR ServerName,
  [in] LPWSTR RootShare,
  [in] LPWSTR FtDfsName,
       DWORD  Flags
);

參數

[in] DomainName

字串的指標，指定要移除之網域型 DFS 命名空間的 Active Directory 網域名稱。 此為必要參數。

[in] ServerName

字串的指標，指定要移除之 DFS 根目標伺服器的名稱。 伺服器必須裝載網域型 DFS 命名空間的根目錄。 此為必要參數。

[in] RootShare

字串的指標，指定要移除之 DFS 根目標共用的名稱。 此為必要參數。

[in] FtDfsName

字串的指標，指定要從中移除根目標的網域型 DFS 命名空間名稱。 此為必要參數。 一般而言，它與 RootShare 參數相同。

Flags

必須為零。

傳回值

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

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

備註

呼叫端必須具有更新目錄服務中 DFS 容器的許可權，而且必須具有 DFS 主機上的系統管理員許可權， (根) 伺服器。

NetDfsRemoveFtRootForced 函式會強制從 DFS 命名空間中移除網域型 DFS 根目標。 例如，當命名空間的根目標伺服器不再提供 (時，它會用來刪除網域型 DFS 命名空間，因為它們已解除委任) 。

因為連絡主要域控制器 (PDC) ，而不是移除 DFS 根目標伺服器來移除 DFS 根目標目標， 所以 NetDfsRemoveFtRootForced 不會更新根目標伺服器的登錄。 在正常情況下，您可以藉由呼叫 NetDfsRemoveFtRoot 函式，從 DFS 網域根目錄移除根目標。

規格需求

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

另請參閱

分散式文件系統 (DFS) 函式

NetDfsAddFtRoot

NetDfsRemoveFtRoot

網路管理功能

網路管理概觀