Platform SDK: Network Management

NetDfsManagerInitialize

The NetDfsManagerInitialize function reinitializes the Dfs service (dfssvc.exe) on the specified server.

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 NetDfsManagerInitialize function.

NET_API_STATUS NetDfsManagerInitialize(
  LPWSTR ServerName, 
  DWORD Flags        
);
 

Parameters

ServerName
[in] Pointer to a null-terminated Unicode character string that specifies the name of the host server that requires reinitialization of the Dfs service. The string must begin with \\. 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.

Remarks

It is recommended that you call the NetDfsManagerInitialize function only if you are thoroughly familiar with the concepts and architecture of Dfs. The function performs the equivalent of a net stop dfs command followed by a net start dfs command.

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