Adapter Property for Network Interfaces

The Adapter property provides the name that is used to uniquely identify the network interface in the system.

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 Adapter 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 AdapterValue;
LPCWSTR AdapterData = L "E100B1";
AdapterValue.Syntax = CLUSPROP_SYNTAX_LIST_VALUE_SZ;
AdapterValue.cbLength = sizeof(AdapterData);
lstrcpyW(AdapterValue.sz, AdapterData);
 

The Adapter property is stored in the system registry.

Because the Adapter 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.