Address Property for Network Interfaces

The Address property provides the primary network address that the node uses for the network interface.

Quick Info

Type: Null-terminated Unicode string
Access: Read-only
Function: ClusterNetInterfaceControl
Structure: CLUSPROP_SZ
Control Code: CLUSCTL_NETINTERFACE_GET_RO_COMMON_PROPERTIES

Remarks

A network interface's primary IP address is an example of the data that is typically stored for the Address property.

The data in the Address property is formatted as xxx.xxx.xxx.xxx where xxx represents a decimal number between 0 and 255.

When ClusterNetworkControl processes the CLUSCTL_NETWORK_GET_RO_COMMON_PROPERTIES control code, it returns a property list that includes the Address 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 AddressValue;
LPCWSTR AddressData = L "10.1.0.2";
AddressValue.Syntax = CLUSPROP_SYNTAX_LIST_VALUE_SZ;
AddressValue.cbLength = sizeof(AddressData);
lstrcpyW(AddressValue.sz, AddressData);
 

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