(DFS) 命名空间创建新的基于域的分布式文件系统。 如果命名空间已存在,该函数将添加指定的根目标。
语法
NET_API_STATUS NET_API_FUNCTION NetDfsAddFtRoot(
[in] LPWSTR ServerName,
[in] LPWSTR RootShare,
[in] LPWSTR FtDfsName,
[in, optional] LPWSTR Comment,
[in] DWORD Flags
);
parameters
[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) |
| Library | Netapi32.lib |
| DLL | Netapi32.dll |