NetDfsAddStdRoot function (lmdfs.h)

Creates a new stand-alone Distributed File System (DFS) namespace.

Syntax

NET_API_STATUS NET_API_FUNCTION NetDfsAddStdRoot(
  [in]           LPWSTR ServerName,
  [in]           LPWSTR RootShare,
  [in, optional] LPWSTR Comment,
  [in]           DWORD  Flags
);

Parameters

[in] ServerName

Pointer to a string that specifies the name of the server that will host the new stand-alone DFS namespace. This parameter is required.

[in] RootShare

Pointer to a string that specifies the name of the shared folder for the new stand-alone DFS namespace on the server that will host the namespace. This parameter is required.

[in, optional] Comment

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

[in] 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 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 Administrator privilege on the DFS server. For more information about calling functions that require administrator privileges, see Running with Special Privileges.

Requirements

Requirement Value
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header lmdfs.h (include LmDfs.h, Lm.h)
Library Netapi32.lib
DLL Netapi32.dll

See also

Distributed File System (DFS) Functions

NetDfsAddFtRoot

NetDfsAddRootTarget

NetDfsRemoveStdRoot

Network Management Functions

Network Management Overview