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.
Type: | Null-terminated Unicode string |
Access: | Read-only |
Function: | ClusterNetInterfaceControl |
Structure: | CLUSPROP_SZ |
Control Code: | CLUSCTL_NETINTERFACE_GET_RO_COMMON_PROPERTIES |
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.
Version: Use Windows NT Server Enterprise Edition 4.0.
Windows CE: Unsupported.
Header: Declared in clusapi.h.