Export (0) Print
Expand All

NetDfsRemoveFtRootForced function

Removes the specified root target from a domain-based Distributed File System (DFS) namespace, even if the root target server is offline. If the last root target of the DFS namespace is being removed, the function also deletes the DFS namespace. A DFS namespace can be deleted without first deleting all the links in it.

Note  The NetDfsRemoveFtRootForced function does not update the registry on the DFS root target server. For more information, see the Remarks section.

Syntax


NET_API_STATUS NetDfsRemoveFtRootForced(
  _In_        LPWSTR DomainName,
  _In_        LPWSTR ServerName,
  _In_        LPWSTR RootShare,
  _In_        LPWSTR FtDfsName,
  _Reserved_  DWORD Flags
);

Parameters

DomainName [in]

Pointer to a string that specifies the name of the Active Directory domain that contains the domain-based DFS namespace to be removed. This parameter is required.

ServerName [in]

Pointer to a string that specifies the name of the DFS root target server to be removed. The server must host a root of the domain-based DFS namespace. This parameter is required.

RootShare [in]

Pointer to a string that specifies the name of the DFS root target share to be removed. This parameter is required.

FtDfsName [in]

Pointer to a string that specifies the name of the domain-based DFS namespace from which to remove the root target. This parameter is required. Typically, it is the same as the RootShare parameter.

Flags

Must be zero.

Return value

If the function succeeds, the return value is NERR_Success.

If the function fails, the return value is a system error code. For a list of error codes, see System Error Codes.

Remarks

The caller must have permission to update the DFS container in the directory service and must have Administrator privilege on the DFS host (root) server.

The NetDfsRemoveFtRootForced function forcibly removes a domain-based DFS root target from a DFS namespace. It is used to delete a domain-based DFS namespace when the root target servers of the namespace are no longer available (for example, because they have been decommissioned).

Because the DFS root target is removed by contacting the primary domain controller (PDC) and not by removing the DFS root target server, NetDfsRemoveFtRootForced does not update the registry of the root target server. Under normal circumstances, you can remove the root target from a DFS domain root by calling the NetDfsRemoveFtRoot function.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2003

Header

LmDfs.h (include LmDfs.h or Lm.h)

Library

Netapi32.lib

DLL

Netapi32.dll

See also

Network Management Overview
Network Management Functions
Distributed File System (DFS) Functions
NetDfsRemoveFtRoot
NetDfsAddFtRoot

 

 

Show:
© 2014 Microsoft