DefaultNetworkRole

Specifies the role that the cluster automatically assigns to any newly discovered or created network. The following table summarizes the attributes of the DefaultNetworkRole property.

Attribute Value
Data type
DWORD
Access
Read/write
Structure
CLUSPROP_DWORD
Minimum
ClusterNetworkRoleNone (0)
Maximum
ClusterNetworkRoleInternalAndClient (3)
Default
ClusterNetworkRoleInternalAndClient

Remarks

The constant for this property is CLUSREG_NAME_CLUS_DEFAULT_NETWORK_ROLE.

When the Cluster service detects a new network, it sets the network's Role property to the value specified by DefaultNetworkRole. Thereafter, the network's role can be changed only by adjusting its Role property. Changing DefaultNetworkRole will not affect previously detected networks.

The DefaultNetworkRole property can be set to one of the following values of the CLUSTER_NETWORK_ROLE enumeration.

Name Value Description
ClusterNetworkRoleNone
0
The network is not used by the cluster.
ClusterNetworkRoleInternalUse
1
The network is used to carry internal cluster communication.
ClusterNetworkRoleClientAccess
2
Not supported.
ClusterNetworkRoleInternalAndClient
3
The network is used to connect client systems and to carry internal cluster communication.

Examples

The following example shows how to set the property value portion of a property list entry for DefaultNetworkRole.

DWORD          DefaultNetworkRoleData = ClusterNetworkRoleInternalAndClient;
CLUSPROP_DWORD DefaultNetworkRoleValue;

DefaultNetworkRoleValue.Syntax.dw = CLUSPROP_SYNTAX_LIST_VALUE_DWORD;
DefaultNetworkRoleValue.cbLength  = sizeof(DWORD);
DefaultNetworkRoleValue.dw        = DefaultNetworkRoleData;

Requirements

Minimum supported client
None supported
Minimum supported server
Windows Server 2008 Enterprise, Windows Server 2008 Datacenter

See also

Cluster Common Properties

CLUSPROP_DWORD

CLUSTER_NETWORK_ROLE