INetwork::SetName method (netlistmgr.h)

The SetName method sets or renames a network.

Syntax

HRESULT SetName(
  [in] BSTR szNetworkNewName
);

Parameters

[in] szNetworkNewName

Zero-terminated string that contains the new name of the network.

Return value

Returns S_OK if the method succeeds. Otherwise, the method returns one of the following values.

Return code Description
E_POINTER
szNetworkNewName is NULL.
HRESULT_FROM_WIN32(ERROR_FILENAME_EXCED_RANGE)
The name provided is too long.

Remarks

The maximum length of a network name can be 128 characters and cannot contain spaces only, tab or "\ /: * ? " < > |".

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header netlistmgr.h

See also

INetwork