AutoFailbackType

Specifies whether the group should automatically be failed back to the node identified as its preferred owner when that node comes back online following a failover. The following table summarizes the attributes of the AutoFailbackType property.

Attribute Value
Data type
DWORD
Access
Read/write
Structure
CLUSPROP_DWORD
Minimum
ClusterGroupPreventFailback (0)
Maximum
ClusterGroupAllowFailback (1)
Default
ClusterGroupPreventFailback

Remarks

The data for the AutoFailbackType property can be set to one of the following values of the CLUSTER_GROUP_AUTOFAILBACK_TYPE enumeration.

Name Value Description
ClusterGroupPreventFailback
0
Prevents failback.
ClusterGroupAllowFailback
1
Allows failback (requires a preferred owners list for the group).

Note that setting this property to ClusterGroupAllowFailback has no effect if you have not specified a preferred owners list for the group. Use the SetClusterGroupNodeList function to specify a preferred owners list.

Examples

The property value portion of a property list entry for AutoFailbackType can be set with the following example code:

DWORD          AutoFailbackTypeData = ClusterGroupAllowFailback;
CLUSPROP_DWORD AutoFailbackTypeValue;

AutoFailbackTypeValue.Syntax.dw = CLUSPROP_SYNTAX_LIST_VALUE_DWORD;
AutoFailbackTypeValue.cbLength  = sizeof(DWORD);
AutoFailbackTypeValue.dw        = AutoFailbackTypeData;

Requirements

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

See also

Group Common Properties

CLUSPROP_DWORD

CLUSTER_GROUP_AUTOFAILBACK_TYPE

SetClusterGroupNodeList