NetDfsRemoveFtRootForced 函数 (lmdfs.h)

从基于域的分布式文件系统 (DFS) 命名空间中删除指定的根目标,即使根目标服务器处于脱机状态也是如此。 如果要删除 DFS 命名空间的最后一个根目标,函数也会删除 DFS 命名空间。 可以删除 DFS 命名空间,而无需先删除其中的所有链接。

注意NetDfsRemoveFtRootForced 函数不会更新 DFS 根目标服务器上的注册表。 有关详细信息,请参阅“备注”部分。
 

语法

NET_API_STATUS NET_API_FUNCTION NetDfsRemoveFtRootForced(
  [in] LPWSTR DomainName,
  [in] LPWSTR ServerName,
  [in] LPWSTR RootShare,
  [in] LPWSTR FtDfsName,
       DWORD  Flags
);

参数

[in] DomainName

指向字符串的指针,该字符串指定要删除的基于域的 DFS 命名空间的 Active Directory 域的名称。 此参数是必需的。

[in] ServerName

指向指定要删除的 DFS 根目标服务器名称的字符串的指针。 服务器必须托管基于域的 DFS 命名空间的根。 此参数是必需的。

[in] RootShare

指向指定要删除的 DFS 根目标共享名称的字符串的指针。 此参数是必需的。

[in] FtDfsName

指向字符串的指针,该字符串指定要从中删除根目标的基于域的 DFS 命名空间的名称。 此参数是必需的。 通常,它与 RootShare 参数相同。

Flags

必须为零。

返回值

如果函数成功,则返回值 NERR_Success

如果函数失败,则返回值为系统错误代码。 有关错误代码的列表,请参阅 系统错误代码

注解

调用方必须有权更新目录服务中的 DFS 容器,并且必须在 DFS 主机 (根) 服务器上具有管理员权限。

NetDfsRemoveFtRootForced 函数强行从 DFS 命名空间中删除基于域的 DFS 根目标。 例如,当命名空间的根目标服务器 (不再可用时,它用于删除基于域的 DFS 命名空间,因为它们已) 解除授权。

由于通过联系主域控制器 (PDC) 而不是删除 DFS 根目标服务器来删除 DFS 根目标, 因此 NetDfsRemoveFtRootForced 不会更新根目标服务器的注册表。 在正常情况下,可以通过调用 NetDfsRemoveFtRoot 函数从 DFS 域根中删除根目标。

要求

要求
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 lmdfs.h (包括 LmDfs.h、Lm.h)
Library Netapi32.lib
DLL Netapi32.dll

另请参阅

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

NetDfsAddFtRoot

NetDfsRemoveFtRoot

网络管理功能

网络管理概述