Name Property for Network Interfaces

The Name property provides the generated name for the network interface. This name only appears on the General page of the property sheet for the network interface and is the name that is passed to the OpenClusterNetInterface function.

Quick Info

Type: Null-terminated Unicode string
Access: Read-only
Function: ClusterNetInterfaceControl
Structure: CLUSPROP_SZ
Control Code: CLUSCTL_NETINTERFACE_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 "E100B1 - NODE1";
NameValue.Syntax = CLUSPROP_SYNTAX_LIST_VALUE_SZ;
NameValue.cbLength = sizeof(NameData);
lstrcpyW(NameValue.sz, NameData);
 

Because the Name property is read-only, it cannot be changed using the CLUSCTL_NETINTERFACE_SET_COMMON_PROPERTIES control code.

QuickInfo

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