NetDfsAddStdRoot

The NetDfsAddStdRoot function creates the root for a new stand-alone Distributed File System (Dfs) implementation.

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

Security Requirements

Administrator privileges are required to successfully execute the NetDfsAddStdRoot function.

NET_API_STATUS NetDfsAddStdRoot(
  LPWSTR ServerName,        
  LPWSTR RootShare,         
  LPWSTR Comment OPTIONAL,  
  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 stand-alone Dfs implementation. The string must begin with \\. 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 new Dfs root. 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, NetDfsRemoveStdRoot, NetDfsAddFtRoot, NetDfsAdd