Name Property for Networks

The Name property provides the name of the network.

Quick Info

Type: Null-terminated Unicode string
Access: Read-only
Function: ClusterNetworkControl
Structure: CLUSPROP_SZ
Control Code: CLUSCTL_NETWORK_GET_RO_COMMON_PROPERTIES

Remarks

When ClusterNetworkControl processes the CLUSCTL_NETWORK_GET_RO_COMMON_PROPERTIES control code, it returns a property list that includes the Name property as one of the entries. The property value portion of the entry contains a CLUSPROP_SZ structure that is set as follows:

CLUSPROP_SZ NameValue;
LPCWSTR NameData = L "NetworkName";
NameValue.Syntax = CLUSPROP_SYNTAX_LIST_VALUE_SZ;
NameValue.cbLength = sizeof(NameData);
lstrcpyW(NameValue.sz, NameData);
 

Applications can change a network's name only by calling SetClusterNetworkName. Because the Name property is read-only, it cannot be changed using the CLUSCTL_NETWORK_SET_COMMON_PROPERTIES control code.

QuickInfo

  Version: Use Windows NT Server Enterprise Edition 4.0.
  Windows CE: Unsupported.
  Header: Declared in clusapi.h.