Platform SDK: Network Management

NetDfsRemoveStdRoot

The NetDfsRemoveStdRoot function removes the server and share at the root of a 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 NetDfsRemoveStdRoot function.

NET_API_STATUS NetDfsRemoveStdRoot(
  LPWSTR ServerName, 
  LPWSTR RootShare,  
  DWORD Flags        
);
 

Parameters

ServerName
[in] Pointer to a null-terminated Unicode character string that specifies the name of the storage server to remove. The server must host the root of a Dfs implementation, and 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 host server to remove. This parameter is required.
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, NetDfsAddStdRoot, NetDfsRemoveFtRoot, NetDfsRemove