从基于域的分布式文件系统 (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) |
| Library | Netapi32.lib |
| DLL | Netapi32.dll |