RemoveNamespaceRootTarget method of the MSFT_DfsNamespaceRootTarget class

Removes a target of a DFS namespace (DFS-N) root. If the target being removed is the last root target, the user is notified.

Syntax

uint32 RemoveNamespaceRootTarget(
  [in] string  NamespaceRoot,
  [in] string  RootTargetPath,
  [in] boolean ForceRemove
);

Parameters

NamespaceRoot [in]

The Universal Naming Convention (UNC) path of the DFS-N root that has a target to be removed. The UNC path can be in one of these two formats:

Server Format	Domain Format
\\ServerName\DFSName	\\DomainName\DFSName

where:

• The ServerName component represents the host name of a DFS root target of a namespace.
• The DomainName component represents the domain name of the domain that hosts the domain-based namespace.
• The DFSName component represents the DFS-N name.

A stand-alone namespace must have a root with the format shown in the first column, as it must contain a server name. A domain-based namespace can have a root with the format from either column, although the second column's format (which contains a domain name instead of a server name) is the preferred format.

RootTargetPath [in]

The UNC path of the target of a DFS-N root.

The DFS-N root target has a format of \\ServerName\ShareName, where the ServerName component is the host name of a DFS-N root target server, and the ShareName component is the share name corresponding to a namespace on the DFS-N root target server.

ForceRemove [in]

True to force the removal of the target; otherwise, false.

Requirements

See also

MSFT_DfsNamespaceRootTarget