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 |