NetDfsRemoveRootTarget 函式 (lmdfs.h)
從網域型 DFS 命名空間中移除 DFS 根目標。 如果根目標是 DFS 命名空間中的最後一個根目標，則此函式會移除 DFS 命名空間。 此函式也可以用來移除獨立 DFS 命名空間。
語法
NET_API_STATUS NET_API_FUNCTION NetDfsRemoveRootTarget(
[in] LPWSTR pDfsPath,
[in, optional] LPWSTR pTargetPath,
[in] ULONG Flags
);
參數
[in] pDfsPath
字串的指標，指定 DFS 命名空間的通用命名慣例 (UNC) 路徑。
針對獨立 DFS 命名空間，此字串的格式應如下：
\\ ServerName\DfsName
其中 ServerName 是裝載 DFS 根目標的伺服器名稱， 而 DfsName 是 DFS 命名空間的名稱。
針對網域型 DFS 命名空間，此字串的格式應如下：
\\ DomainName\DomDfsName
其中 DomainName 是裝載網域型 DFS 命名空間且 DomDfsName 是 DFS 命名空間的名稱。
[in, optional] pTargetPath
Null 終止 Unicode 字串的指標，指定 pDfsPath 參數中所指定 DFS 命名空間之 DFS 根目標的 UNC 路徑。
如果是獨立 DFS 命名空間，此參數必須是 NULL。 如果是網域型 DFS 命名空間，字串的格式應如下：
\\ ServerName\RootShare
其中 ServerName 是裝載 DFS 根目標的伺服器名稱， 而 RootShare 是伺服器上的資料夾名稱。
[in] Flags
指定移除作業類型的旗標。 針對獨立 DFS 命名空間，此參數必須為零。 如果是網域型 DFS 命名空間，它可以是零或下列值。 如果是零，這表示一般移除作業。
DFS_FORCE_REMOVE (0x80000000)
如果為網域型 DFS 命名空間指定此旗標，即使無法存取，也會移除根目標。
傳回值
如果函式成功，傳回值會NERR_Success。
如果函式失敗，則傳回值是系統錯誤碼。 如需錯誤碼的清單，請參閱 系統錯誤碼。
備註
呼叫端必須在 DFS 伺服器上具有系統管理員許可權。
下列清單會根據所需的結果，顯示您應該指定的參數值。
| pDfsPath 參數 | pTargetPath 參數 | 結果 |
|---|---|---|
| \\DomainName\DomDfsName | \\ServerName\RootShare | 刪除 Windows 2000 模式或 Windows Server 2008 模式網域型 DFS 根目標。 如果目標是 DFS 命名空間的最後一個根目標，函式也會刪除 DFS 命名空間。 |
| \\ServerName\DfsName | NULL | 刪除獨立 DFS 命名空間。 |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista SP1 |
| 最低支援的伺服器 | Windows Server 2008 |
| 目標平台 | Windows |
| 標頭 | lmdfs.h (包括 LmDfs.h、Lm.h) |
| 程式庫 | Netapi32.lib |
| Dll | Netapi32.dll |