NetDfsRemoveFtRoot 函数 (lmdfs.h)

从基于域的分布式文件系统 (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

另请参阅

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

NetDfsAddFtRoot

NetDfsRemove

NetDfsRemoveFtRootForced

网络管理功能

网络管理概述