NetDfsAddFtRoot 函数 (lmdfs.h)

(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

另请参阅

分布式文件系统 (DFS) 函数

NetDfsAdd

NetDfsAddRootTarget

NetDfsAddStdRoot

NetDfsRemoveFtRoot

网络管理功能

网络管理概述