Windows Dev Center

NetDfsRemoveFtRoot function

Removes the specified root target from a domain-based Distributed File System (DFS) namespace. 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.

Syntax


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

Parameters

ServerName [in]

Pointer to a string that specifies the server name of the root target to be removed. The server must host the root of a 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

This parameter is reserved and 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 root target server must be available and accessible; otherwise, the call to the NetDfsRemoveFtRoot function will fail.

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.

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
NetDfsAddFtRoot
NetDfsRemoveFtRootForced
NetDfsRemove

 

 

Show:
© 2015 Microsoft