Skip to content

Latest commit

 

History

History
118 lines (77 loc) · 3.68 KB

nf-lmdfs-netdfsaddftroot.md

File metadata and controls

118 lines (77 loc) · 3.68 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:lmdfs.NetDfsAddFtRoot
NetDfsAddFtRoot function (lmdfs.h)
Creates a new domain-based Distributed File System (DFS) namespace. If the namespace already exists, the function adds the specified root target to it.
NetDfsAddFtRoot
NetDfsAddFtRoot function [Distributed File System]
_win32_netdfsaddftroot
dfs.netdfsaddftroot
fs.netdfsaddftroot
lmdfs/NetDfsAddFtRoot
netmgmt.netdfsaddftroot
dfs\netdfsaddftroot.htm
Dfs
df3192f8-f8fc-40ad-a5ff-fb991befff09
12/05/2018
NetDfsAddFtRoot, NetDfsAddFtRoot function [Distributed File System], _win32_netdfsaddftroot, dfs.netdfsaddftroot, fs.netdfsaddftroot, lmdfs/NetDfsAddFtRoot, netmgmt.netdfsaddftroot
lmdfs.h
LmDfs.h, Lm.h
Windows
Windows Vista
Windows Server 2008
Netapi32.lib
Netapi32.dll
Windows
19H1
NetDfsAddFtRoot
lmdfs/NetDfsAddFtRoot
c++
APIRef
kbSyntax
DllExport
Netapi32.dll
NetDfsAddFtRoot

NetDfsAddFtRoot function

-description

Creates a new domain-based Distributed File System (DFS) namespace. If the namespace already exists, the function adds the specified root target to it.

-parameters

-param ServerName [in]

Pointer to a string that specifies the name of the server that will host the new DFS root target. This value cannot be an IP address. This parameter is required.

-param RootShare [in]

Pointer to a string that specifies the name of the shared folder on the server that will host the new DFS root target. This parameter is required.

-param FtDfsName [in]

Pointer to a string that specifies the name of the new or existing domain-based DFS namespace. This parameter is required. For compatibility reasons, it should specify the same string as the RootShare parameter.

-param Comment [in, optional]

Pointer to a string that contains an optional comment associated with the DFS namespace.

-param Flags [in]

This parameter is reserved and must be zero.

-returns

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 share specified by the RootShare parameter must already exist on the server that will host the new DFS root target. This function does not create a new share.

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.

-see-also

Distributed File System (DFS) Functions

NetDfsAdd

NetDfsAddRootTarget

NetDfsAddStdRoot

NetDfsRemoveFtRoot

Network Management Functions

Network Management Overview