NetDfsAddFtRoot

The NetDfsAddFtRoot function creates the root of a new domain-based Distributed File System (Dfs) implementation. If the root already exists, the function adds (joins) the specified server and share to the root.

Note  This function is currently being evaluated and may or may not be supported in future versions.

Security Requirements

Users having permission to update the Dfs container in the directory service can successfully execute the NetDfsAddFtRoot function.

NET_API_STATUS NetDfsAddFtRoot(
  LPWSTR ServerName,  
  LPWSTR RootShare,   
  LPWSTR FtDfsName,   
  LPWSTR Comment,     
  DWORD Flags         
);

Parameters

ServerName

[in] Pointer to a null-terminated Unicode character string that specifies the name of the storage server that will host the root of the new domain-based Dfs implementation. The string must begin with \\. If the root already exists, this parameter specifies the name of a server to add to the existing root. This parameter is required.

RootShare

[in] Pointer to a null-terminated Unicode character string that specifies the name of the share on the storage server that will host the root of the new domain-based Dfs implementation. If the root already exists, this parameter specifies the name of a share to add to the existing root. This parameter is required.

FtDfsName

[in] Pointer to a null-terminated Unicode character string that specifies the name of the root to create or join to the domain-based Dfs. This parameter is required.

Comment

[in] Pointer to a null-terminated Unicode character string that contains an optional comment associated with the Dfs link.

Flags

[in] Must be zero.

Return Values

If the function succeeds, the return value is NERR_Success.

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

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in Lmdfs.h; include Lm.h.
  Library: Use Netapi32.lib.

See Also

Network Management Overview, Network Management Functions, Distributed File System (Dfs) Functions, NetDfsRemoveFtRoot, NetDfsAdd