Specifies the maximum number of failover attempts that can be made on a group within a time interval defined by FailoverPeriod. The following table summarizes the attributes of the FailoverThreshold property.

Attribute Value
Data type DWORD
Access Read/write
Minimum 0
Maximum 0xFFFFFFFF
Default 0xFFFFFFFF


If the Cluster service exceeds the number of failover attempts specified by FailoverThreshold within the time interval specified by FailoverPeriod, it stops trying to fail over the group.

For example, if FailoverThreshold is set to 2 and RestartPeriod is set to 1, a node can tolerate 2 failover attempts of the group within any 1-hour interval. More than 3 failover attempts can occur, as long as they occur over an interval that is greater than 1 hour.

If a value for FailoverThreshold is not specified, the default value is the number of nodes in the cluster minus 1. This is represented as 0xFFFFFFFF.


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

DWORD          FailoverThresholdData = 5;
CLUSPROP_DWORD FailoverThresholdValue;

FailoverThresholdValue.Syntax.dw = CLUSPROP_SYNTAX_LIST_VALUE_DWORD;
FailoverThresholdValue.cbLength  = sizeof(DWORD);
FailoverThresholdValue.dw        = FailoverThresholdData;


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

See also